TOtoksta
Creators

Run a creator discovery search

Ranked discovery search over LinkedIn creators using keyword relevance. keywords is required. Returns meta.ranking_source (rpc or fallback).

post/v1/creators/discovery-search

Request

Request body

keywordsstring[] required

Search keywords (required, at least one). NOTE: this is keywords, not query.

platform'linkedin' | 'youtube'

Reserved. Discovery search currently runs against LinkedIn regardless of this value.

limitinteger

Number of creators to return (1-100). Defaults to 50.

offsetinteger

Result offset for pagination. Defaults to 0.

search_mode'auto' | 'strict' | 'balanced' | 'broad'

Ranking strictness. Defaults to auto.

Example request

{
  "platform": "linkedin",
  "keywords": [
    "SaaS",
    "marketing",
    "growth"
  ],
  "limit": 5
}

Response

Ranked discovery results. meta includes keywords_used, ranking_source, search_mode, and pagination.

successtrue required
dataobject required

Operation payload. See the example for the exact field structure.

Example response

{
  "success": true,
  "data": {
    "creators": [
      {
        "id": "f0e1d2c3-b4a5-4678-9abc-def012345678",
        "name": "Jane Marketer",
        "bio": "Head of Growth. I write about B2B SaaS and demand gen.",
        "location": "London, UK",
        "avatar_url": "https://media.licdn.com/.../jane.jpg",
        "content_categories": [
          "marketing",
          "saas"
        ],
        "target_audiences": [
          "marketers",
          "founders"
        ],
        "languages": [
          "en"
        ],
        "platform": "linkedin",
        "handle": "jane-marketer",
        "profile_url": "https://www.linkedin.com/in/jane-marketer/",
        "metrics": {
          "followers_count": 48200,
          "engagement_rate": 2.31,
          "avg_posts_per_month": 12,
          "avg_views_per_post": 15400,
          "shares_per_post": 9,
          "comments_per_post": 34,
          "reactions_per_post": 410
        },
        "updated_at": "2026-05-20T11:04:00Z",
        "score": 87,
        "match_rank": 87
      }
    ]
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.