Creator profiles

The profile is read from the platform at the moment you call; nothing is stored, and no creator needs to be registered first.

Read a profile

platform is required, because the same handle can belong to different people on Instagram and TikTok. The handle may include a leading @; pass the handle, not a profile URL.

curl -G {API_BASE_URL}/v1/profile \
  -H "Authorization: Bearer <API_TOKEN>" \
  --data-urlencode "platform=instagram" \
  --data-urlencode "handle=@creator_jane"

{
  "platform": "instagram",
  "profile": {
    "handle": "creator_jane",
    "accountId": "270702400",
    "secUid": null,
    "displayName": "Creator Jane",
    "bio": "Creator",
    "profilePictureUrl": "https://...",
    "isVerified": false,
    "isPrivate": false,
    "followerCount": 12000,
    "mediaCount": 84
  }
}

Any field is null when the platform does not expose it.

Errors

429, 502 and 503 are transient and worth retrying; see Data lookup errors.

YouTube channels and X profiles

YouTube channel

• YouTube. Input: channel. Returns the channel.

X profile

• X. Input: handle. Returns the account's public profile.

More profile data

Extended profile

• Instagram. Input: handle, or accountId. Returns following count, external link and bio links, business category, whether the account is a business or professional account, highlight count and recent posts. Business email and phone appear only when the account makes them public, so they are often null. Reading by accountId adds account type, category and city, but not business email or phone.
• TikTok. Input: handle. Returns following count, total likes, video count, friend count, bio link, language, account creation date, and whether the account is a TikTok Shop seller.

Story highlights

• Instagram. Input: handle or accountId. Two calls. The first returns the highlights, each with a title and cover image. The second reads one highlight and returns its item count, creation time and each item's id, time taken, duration, and image and video versions.

Live

• TikTok. Input: handle. Returns a snapshot of the creator's live stream: whether it is live, title, start time, cover image, current viewers and enter count.