Contributors

The Contributors API returns creator profiles, engagement metrics, mention history, and top contributor rankings.

List contributors

GET /v1/contributors

Returns a paginated list of creators matching the specified filters.

Query parameters

Parameter	Type	Description
platform	string	Filter by platform: tiktok, instagram, youtube, x
niche	string	Filter by content niche (e.g., web3, gaming, fitness)
region	string	ISO 3166-1 alpha-2 country code
min_followers	integer	Minimum follower count
min_quality_score	number	Minimum Quality Score (0–100)
limit	integer	Results per page. Default: 20, max: 100
cursor	string	Pagination cursor from previous response

Example request

GET /v1/contributors?platform=tiktok&niche=web3&min_followers=10000&limit=20
Authorization: Bearer YOUR_API_KEY

Example response

{
  "data": [
    {
      "id": "ctr_abc123",
      "handle": "@creatorhandle",
      "platform": "tiktok",
      "followers": 45200,
      "quality_score": 82.4,
      "engagement_rate": 0.064,
      "niche": ["web3", "crypto"],
      "region": "US",
      "mention_count_30d": 14
    }
  ],
  "next_cursor": "eyJpZCI6..."
}

Get a contributor

GET /v1/contributors/{id}

Returns the full profile for a single creator including engagement history and mention history.

Path parameters

Parameter	Type	Description
id	string	Creator ID (e.g., ctr_abc123)

Example response

{
  "data": {
    "id": "ctr_abc123",
    "handle": "@creatorhandle",
    "platform": "tiktok",
    "followers": 45200,
    "quality_score": 82.4,
    "engagement_rate": 0.064,
    "smart_followers": 3800,
    "niche": ["web3", "crypto"],
    "region": "US",
    "mention_history": [
      {
        "date": "2026-05-01",
        "count": 3,
        "brands": ["Brand A", "Brand B"]
      }
    ],
    "top_content": [
      {
        "url": "https://tiktok.com/@creatorhandle/video/...",
        "views": 280000,
        "posted_at": "2026-04-22"
      }
    ]
  }
}

Top contributors

GET /v1/contributors/top

Returns the top-ranked creators for a given time window and scoring metric.

Query parameters

Parameter	Type	Description
metric	string	Ranking metric: quality_score, engagement_rate, mention_count
platform	string	Filter by platform
period	string	Time window: 7d, 30d, 90d
limit	integer	Number of results. Default: 10, max: 50