Get the number of high-follower followers of a specific creator

Retrieves the number of high-follower followers of a specified social media creator based on multiple filtering parameters.

This API supports three work platforms; YouTube, TiKTok, and Instagram.

POST /v1/social/creators/highfollower-audience

Basic auth

curl 'https://api.staging.insightiq.ai/v1/social/creators/highfollower-audience' \
  --request POST \
  --header 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  --header 'Content-Type: application/json' \
  --data '{
  "work_platform_id": "work_platform_01JXY9AZK4KV",
  "identifier": "example",
  "dry_run": false,
  "exclude_exported": false,
  "audience_type": "all",
  "follower_count": {
    "min": 1000
  },
  "has_email": false,
  "max_results": 1
}'

{
  "id": "id_01JXY9AZK4KV",
  "work_platform": {
    "id": "9bb8913b-ddd9-430b-a66a-d74d846e6c66",
    "name": "Instagram, Twitter",
    "logo_url": "https://insightiq.ai/storage/instagram.png"
  },
  "identifier": "example",
  "dry_run": false,
  "audience_type": "all",
  "follower_count": {
    "min": 1000
  },
  "has_email": false,
  "status": "example"
}

Body

· AudienceDataRequest

application/json

work_platform_id string required

The social platform of the creator (e.g., instagram, tiktok, youtube)

identifier string required

The creator’s username or profile link

dry_run boolean · default: false

If true, provides a count estimation of followers without returning their full data.

exclude_exported boolean · default: false

If set to true, records already exported in earlier requests will be filtered out, preventing duplicate exports. If false, all matching records are returned, including previously exported ones.

audience_type any · default: all· enum

Segment of the creator’s audience should be exported

followers and likers are only valid for Instagram/TikTok
commenters is only valid for YouTube

values

all
followers
likers
commenters

follower_count object

Follower count of the creator

has_email boolean · default: false

For dry_run=true requests, also returns how many users have a known email (optional)

max_results integer

Defines the maximum number of audience records to be returned in the response, default =100; however, when dry_run=true, the value should be null

Body

Responses