Creator Data & Service Levels
Permission scopes, service levels, and field profiles for each platform.
Permission Scopes
Each API Key is assigned specific permission scopes that control which endpoints can be accessed.
| Scope Key | Name | Method | Path |
|---|---|---|---|
| creator:tiktok:search | TikTok Search | POST | /v1/creators/tiktok/search |
| creator:youtube:search | YouTube Search | POST | /v1/creators/youtube/search |
| creator:instagram:search | Instagram Search | POST | /v1/creators/instagram/search |
| creator:twitter:search | Twitter Search | POST | /v1/creators/twitter/search |
| collection:submit | Submit Collection | POST | /v1/collection/tasks/submit |
| collection:status | Task Status | POST | /v1/collection/tasks/status |
| collection:data | Task Data | POST | /v1/collection/tasks/data |
| collection:keyword-submit | Keyword Collection | POST | /v1/collection/tasks/keyword-submit |
| collection:export | Export Data | POST | /v1/collection/tasks/export |
| files:download | File Download | POST | /v1/files/download-url |
Service Levels (S1 / S2 / S3)
Search endpoints support three service levels. Higher levels return more fields and cost more credits per result.
S1
Basic Listing
Basic identity fields for quick filtering and list building.
Pricing follows your active account rules
S2
Precision Outreach
Full demographics, engagement metrics, and contact details for outreach.
Pricing follows your active account rules
S3
Deep Profile
Complete audience demographics including gender, country, language, and age distribution.
Pricing follows your active account rules
Field Profiles by Platform
Each platform and service level returns a specific set of fields. Fields not included in your service level return null.
| Fields | TikTok | YouTube | Instagram | Twitter |
|---|---|---|---|---|
| uid | S1 | S1 | S1 | S1 |
| username | S1 | S1 | S1 | S1 |
| nickname | S1 | S1 | S1 | S1 |
| avatar_url | S1 | S1 | S1 | S1 |
| profile_url | S1 | — | S1 | S1 |
| followers_count | S1 | S2 | S2 | S1 |
| likes_count | S1 | — | — | — |
| video_count | S1 | S2 | S2 | S1 |
| has_showcase | S1 | — | — | — |
| has_email | S1 | S1 | S1 | S1 |
| has_mcn | S1 | — | — | — |
| has_line | S1 | — | — | — |
| has_zalo | S1 | — | — | — |
| last_video_publish_date | S1 | — | — | — |
| country_code | S2 | S2 | S2 | S2 |
| gender | S2 | S2 | S2 | S2 |
| engagement_rate | S2 | S2 | S2 | S2 |
| avg_views | S2 | S2 | S2 | S2 |
| views_per_follower | S2 | — | — | — |
| is_verified | S2 | S2 | S2 | S2 |
| last10_video_views_per_sub | S2 | S2 | S2 | S2 |
| last10_med_video_views_cnt | S2 | S2 | S2 | S2 |
| last10_med_video_views_per_sub | S2 | S2 | S2 | S2 |
| product_categories | S2 | — | — | — |
| industry_categories | S2 | S2 | S2 | S2 |
| bio | S2 | S2 | S2 | S2 |
| hashtags | S2 | S2 | S2 | S2 |
| S2 | S2 | S2 | S2 | |
| link_whatsapp | S2 | — | S2 | S2 |
| link_line | S2 | — | — | — |
| link_zalo | S2 | — | — | — |
| mcn | S2 | — | — | — |
| language | S2 | S2 | S2 | S2 |
| audience_female_rate | S3 | S3 | S3 | S3 |
| audience_country_code_list | S3 | S3 | S3 | S3 |
| audience_language_code_list | S3 | — | S3 | S3 |
| audience_age_id_list | S3 | — | S3 | S3 |
| channel_url | — | S1 | — | — |
| has_whatsapp | — | S1 | S1 | S1 |
| last_video_publish_time | — | S1 | S1 | S1 |
| view_count | — | S2 | — | — |
| avg_views_short | — | S2 | — | — |
| avg_views_long | — | S2 | — | — |
| engagement_rate_short | — | S2 | — | — |
| engagement_rate_long | — | S2 | — | — |
| last10_video_views_per_sub_short | — | S2 | — | — |
| last10_video_views_per_sub_long | — | S2 | — | — |
| last10_med_video_views_cnt_short | — | S2 | — | — |
| last10_med_video_views_cnt_long | — | S2 | — | — |
| last10_med_video_views_per_sub_short | — | S2 | — | — |
| last10_med_video_views_per_sub_long | — | S2 | — | — |
| — | S2 | — | — | |
| audience_language_list | — | S3 | — | — |
| audience_age_list | — | S3 | — | — |
| is_blue_verified | — | — | — | S2 |
| recent_videos | — | — | — | S2 |