TOtoksta
Creators

Find thought leaders for a topic

Start an async thought leaders job for a topic. Requires at least 5 keywords. Runs discovery, enrichment refresh, and recent-post content validation. Poll GET /v1/jobs/{job_id} and fetch results via POST /v1/jobs/results when status is terminal. Credits are reserved up front from max_candidates_to_analyze and mode (broad: 1, balanced: 2, strict: 3 credits per creator analyzed); unused credits are refunded after completion.

post/v1/creators/thought-leaders

Request

Request body

keywordsstring[] required

Topic keywords. REQUIRED and must contain at least 5 strings.

countinteger

Max thought leaders to return. Defaults to 10.

min_followersnumber

Minimum follower count. Defaults to 30000.

min_reactions_per_postnumber

Minimum average reactions per post. Defaults to 50.

min_content_match_scorenumber

Minimum content match score (0-100). Defaults to 60.

hide_brandsboolean

Exclude brand/company pages. Defaults to true.

mode'strict' | 'balanced' | 'broad'

Ranking strictness. Defaults to balanced.

locationstring

Single location filter.

languagestring

Single language filter.

posts_to_analyze10 | 20 | 30

Posts analyzed per candidate. One of 10, 20, 30. Defaults to 10.

max_candidates_to_analyzeinteger

Cap on candidates analyzed. Defaults to 100.

Example request

{
  "keywords": [
    "B2B SaaS",
    "demand generation",
    "marketing analytics",
    "growth",
    "ABM"
  ],
  "count": 10,
  "min_followers": 30000,
  "mode": "balanced"
}

Response

Job accepted. Poll job status and results endpoints until terminal.

successtrue required
dataobject required

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

Example response

{
  "success": true,
  "data": {
    "job_id": "a1b2c3d4-e5f6-4789-a012-3456789abcde",
    "job_type": "thought_leaders",
    "status": "queued"
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

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