vlayer docsData lookups
Creator profiles
Read a public Instagram or TikTok profile from the creator's handle, including follower count and the account id that never changes.
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
}
}| Field | Notes |
|---|---|
accountId | The platform's id for the account. It stays the same when the handle changes, and matches owner.accountId from Post metrics |
secUid | TikTok only; null on Instagram |
profilePictureUrl | A signed platform URL that expires. Download the image promptly if you need to keep it |
isVerified | The platform's verified badge |
followerCount, mediaCount | Public counts at the time of the call |
Any field is null when the platform does not expose it.
Errors
| Status | error | Meaning |
|---|---|---|
403 | PROFILE_RESTRICTED | The profile exists, but the platform withholds it from public lookups. Do not retry |
404 | PROFILE_UNAVAILABLE | The account does not exist or was deactivated. Do not retry |
422 | VALIDATION_ERROR | platform or handle is missing, or platform is not instagram or tiktok |
429, 502 and 503 are transient and worth retrying; see Data lookup errors.
Last updated on