Tracking
List tracked creators
get/v1/tracking/creators
Request
- Base URL: https://api.virlo.ai
- URL: https://api.virlo.ai/v1/tracking/creators
- Auth: HTTP bearer
Query parameters
pagenumber
Example:1
Page number, 1-indexed (default 1).
limitnumber
Example:20
Items per page (1-100, default 20). Values above 100 are clamped.
platform'tiktok' | 'youtube' | 'instagram'
Only items from this platform. Omit for all platforms.
searchstring
Search by handle or display name (case-insensitive partial match)
Response
List of tracked creators
Example response
{
"data": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"platform": "tiktok",
"platform_handle": "khaby.lame",
"profile_url": "https://www.tiktok.com/@khaby.lame",
"display_name": "Khabane lame",
"avatar_url": "https://auth.virlo.ai/storage/v1/object/public/avatars/e9aa0e4c-b385-40a1-b829-9f72d07bda76.jpg",
"bio": "If u wanna laugh u r in the right place",
"is_verified": true,
"status": "active",
"scrape_cadence": "daily",
"enrichment_status": "completed",
"finalized": true,
"pending_jobs": [
{
"type": "viral_analysis",
"status": "processing",
"job_id": "aud_01HXYZ",
"poll_url": "/v1/orbit/orb_01HXYZ/analysis/latest",
"result_path": "data.analysis_data",
"webhook_event": "orbit.run.completed",
"started_at": "2026-05-22T05:00:00.000Z",
"retry_after_seconds": 15
}
],
"latest_followers": 162400000,
"latest_following": 8200000,
"latest_total_likes": 2400000000,
"latest_total_views": 8455553979,
"latest_total_videos": 1203,
"last_scraped_at": "2026-03-23T14:00:00.000Z",
"growth_rate": 0.0523,
"followers_gained": 8500,
"next_scrape_at": "2026-03-24T02:00:00.000Z",
"profile_metadata": {
"country": "US",
"language": "en",
"website": "https://example.com",
"external_links": []
},
"created_at": "2026-03-20T10:30:00.000Z",
"updated_at": "2026-03-23T14:00:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 42,
"total_pages": 3,
"has_next_page": true
}
}Changes
No recorded changes to this operation across all 1 revision of this API.