Creator List

curl --request GET \
  --url https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "<string>",
      "youtube_channel_id": "<string>",
      "first_seen_at": "2023-11-07T05:31:56Z",
      "is_stale": true,
      "influence_score": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "is_shortlisted": true,
      "has_brief": true,
      "display_name": "<string>",
      "handle": "<string>",
      "channel_url": "<string>",
      "channel_description": "<string>",
      "thumbnail_url": "<string>",
      "channel_publish_date": "2023-12-25",
      "country": "<string>",
      "channel_type": "<string>",
      "channel_attributes": [
        "<string>"
      ],
      "last_updated_at": "2023-11-07T05:31:56Z",
      "tier_type": "Nano",
      "shortlist_id": "<string>",
      "partnership_opportunities": [
        "CREATOR_PARTNERSHIPS"
      ],
      "subscriber_count": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "video_count": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "view_count": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "likes_count": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "comments_count": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "engagement_rate": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "average_views_per_video": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "average_likes_per_video": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "average_comments_per_video": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "is_active_shorts_creator": true,
      "language_distributions": [
        {
          "language_code": "<string>",
          "proportion": 123
        }
      ],
      "audience_age_ranges": {},
      "audience_genders": {},
      "audience_countries": {},
      "top_videos": [
        {
          "youtube_video_id": "<string>",
          "title": "<string>",
          "url": "<string>",
          "thumbnail_url": "<string>",
          "views_count": 123,
          "likes_count": 123,
          "comments_count": 123,
          "publish_date": "2023-12-25"
        }
      ]
    }
  ],
  "pagination": {
    "page": 123,
    "page_size": 123,
    "total": 123
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Creators

Creator List

Creators across every project in the workspace, ranked by Influence Score by default. Narrow the results with country, engine, brand, category, analysis (project), and persona filters. Set shortlisted_only=true to only return creators already on the workspace’s shortlist. Sort with sort_column + sort_direction (defaults to influence_score desc). search_query ILIKE-filters display_name or handle. creator_countries keeps only creators whose channel declares one of the given countries (‘unknown’ for none declared), without changing any score; it is distinct from countries, which is the analysis’ country. Defaults to the last month when no date range is given.

GET

organizations

{organization_id}

workspaces

{workspace_id}

creators

Creator List

curl --request GET \
  --url https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.shareofsearch.jplus.io/v1/organizations/{organization_id}/workspaces/{workspace_id}/search/creators")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "<string>",
      "youtube_channel_id": "<string>",
      "first_seen_at": "2023-11-07T05:31:56Z",
      "is_stale": true,
      "influence_score": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "is_shortlisted": true,
      "has_brief": true,
      "display_name": "<string>",
      "handle": "<string>",
      "channel_url": "<string>",
      "channel_description": "<string>",
      "thumbnail_url": "<string>",
      "channel_publish_date": "2023-12-25",
      "country": "<string>",
      "channel_type": "<string>",
      "channel_attributes": [
        "<string>"
      ],
      "last_updated_at": "2023-11-07T05:31:56Z",
      "tier_type": "Nano",
      "shortlist_id": "<string>",
      "partnership_opportunities": [
        "CREATOR_PARTNERSHIPS"
      ],
      "subscriber_count": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "video_count": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "view_count": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "likes_count": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "comments_count": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "engagement_rate": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "average_views_per_video": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "average_likes_per_video": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "average_comments_per_video": {
        "value": 123,
        "prev_value": 123,
        "unit": "<string>"
      },
      "is_active_shorts_creator": true,
      "language_distributions": [
        {
          "language_code": "<string>",
          "proportion": 123
        }
      ],
      "audience_age_ranges": {},
      "audience_genders": {},
      "audience_countries": {},
      "top_videos": [
        {
          "youtube_video_id": "<string>",
          "title": "<string>",
          "url": "<string>",
          "thumbnail_url": "<string>",
          "views_count": 123,
          "likes_count": 123,
          "comments_count": 123,
          "publish_date": "2023-12-25"
        }
      ]
    }
  ],
  "pagination": {
    "page": 123,
    "page_size": 123,
    "total": 123
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organization_id

string

required

workspace_id

string

required

Query Parameters

page

integer

default:1

Required range: x >= 1

page_size

integer

default:20

Required range: 1 <= x <= 100

shortlisted_only

boolean

default:false

Only return creators already on the workspace's shortlist.

sort_column

enum<string> | null

Available options:

influence_score,

display_name,

handle,

first_seen_at,

subscriber_count,

video_count,

view_count,

likes_count,

comments_count,

engagement_rate,

average_views_per_video

sort_direction

enum<string> | null

Available options:

asc,

desc

search_query

string | null

Case-insensitive substring match on display_name or handle.

creator_countries

string[] | null

Filter by the creators' declared country code; 'unknown' selects creators with no declared country. Distinct from countries, which is the analysis' country.

date_start

string<date> | null

Start of the date range (YYYY-MM-DD).

date_end

string<date> | null

End of the date range (YYYY-MM-DD).

sources

enum<string>[] | null

Filter by engine.

Available options:

Bing,

BingAIO,

ChatGPT,

Perplexity,

Google,

GoogleAIO,

GoogleAIMode,

Claude,

Gemini,

AmazonRufus,

Grok,

Copilot,

Mistral,

MuseSpark

persona_ids

string[] | null

Filter by a list of persona IDs.

countries

enum<string>[] | null

Filter by country.

Available options:

AR,

AT,

AU,

AE,

BH,

BE,

BO,

BR,

CA,

CN,

CO,

CR,

DK,

DO,

EC,

ES,

FI,

FR,

DE,

GB,

GT,

HK,

HU,

ID,

IE,

IL,

IN,

IT,

JP,

KR,

KW,

LU,

MA,

MX,

MY,

NG,

NL,

NO,

NZ,

PA,

PE,

PH,

PK,

PL,

PT,

QA,

RO,

SA,

SE,

SG,

CH,

TH,

TR,

TW,

US,

VN,

ZA

brands

string[] | null

Filter by brand.

Response

Successful Response

data

CreatorResponse · object[]

required

Items for the current page.

Show child attributes

pagination

Pagination · object

required

Pagination metadata.

Show child attributes

Overview

Core API

Search API

Creator List

Authorizations

Path Parameters

Query Parameters

Response