TOtoksta
Creators

Search public creators

Keyword/filter search over the public creator database. Returns a single page of creators with cursor pagination.

post/v1/creators/search

Request

Request body

querystring

Free-text search matched against creator name and bio.

platform'linkedin' | 'youtube'

Creator platform. Defaults to linkedin.

cursorstring

Pagination cursor from the previous response's meta.next_cursor.

limitinteger

Page size (1-100). Defaults to 50.

sort_by'followers_count' | 'engagement_rate' | 'avg_posts_per_month' | 'avg_views_per_post' | 'shares_per_post' | 'comments_per_post' | 'reactions_per_post' | 'name' | 'updated_at'

Field to sort by. Defaults to followers_count.

sort_order'asc' | 'desc'

Sort direction. Defaults to desc.

Example request

{
  "platform": "linkedin",
  "query": "growth marketing",
  "limit": 25,
  "filters": {
    "min_followers": 5000,
    "hide_brands": true
  }
}

Response

Creator search results.

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"
      }
    ]
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

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