Creator lists usually hold one handle per network, and a creator's handles often differ between networks. This guide looks up one creator on YouTube, Instagram, X and TikTok, links the accounts that really belong to them, and stores the results as rows your team can check. Every example uses one API key and the same four profile routes.
The running example is the fitness creator Chloe Ting. Her YouTube channel is @ChloeTing, but her Instagram and TikTok are chloe_t and her X account is chloe_ting. Every screenshot and table here comes from real lookups.
You'll need an API key, and the TypeScript SDK or curl. You can try each lookup in the Playground first.
Why the same handle isn't the same person
Platforms don't share an ID you can join on, and creators often can't get the same handle everywhere. Trying the YouTube handle chloeting on X and TikTok finds an account on both, and neither is her: they're unrelated accounts with a few dozen followers. Both lookups still succeed and still cost a credit.
The reliable signal is what the creator says about themselves. Most profiles have a place for links, and creators use it to point to their other accounts. So the order is:
- Look up the account you trust most.
- Read the links on it.
- Look up the accounts those links name.
- Only then try matching handles for the platforms still missing, and check what you find.
How the four profile responses differ
The four routes are GET /v1/youtube/channel, GET /v2/instagram/profiles/{profile}, GET /v1/twitter/profiles/{handle} and GET /v1/tiktok/profiles/{handle}. Every response has data.lookupStatus, the account itself (in data.profile, or data.channel on YouTube) and a meta object with requestId and creditsCharged. Follower counts and links sit in different places:
| Platform | Followers | Links the creator added |
|---|---|---|
| YouTube | data.metrics.subscribers | data.channel.externalLinks |
data.profile.metrics.followers | data.profile.bioLinks, data.profile.externalUrl | |
| X | data.metrics.followers | data.profile.website |
| TikTok | data.metrics.followers | data.profile.bioLink.url |
lookupStatus is found, not_found or, on Instagram, X and TikTok, private. A private or missing account is still an HTTP 200, so always check lookupStatus before reading counts. When it isn't found, the account and metrics are usually null.

Step 1: look up the account you trust
Start with the account you're surest about: the one the creator or your client gave you, or the platform where you found them. Here that's the YouTube channel. The route takes a handle, a channelId or a channel url.
The same lookup with the SDK:
Reference: Get YouTube channel.
Step 2: read the links the creator declared
The channel's externalLinks list everything Chloe Ting added to her channel, including her Instagram and X accounts.

Turn those links into handles. This resolver starts from a YouTube anchor, so it skips YouTube links: the channel is already known, and a /channel/ID path is not a handle. Parsing the other profile URLs avoids treating @ mentions in bio text as account links:
A creator can list more than one account on a platform. Chloe Ting's channel also links a second Instagram account, so if you need every account, keep all the candidates instead of the first. Links to a page of links, such as Linktree, need one more lookup: the Linktree profile route returns the links on it.
Step 3: look up each declared account
Look up the declared accounts in parallel, and read the follower count from wherever each platform keeps it:
result.ok === false means the request failed (a bad key, no credits, or a temporary error such as 503). result.ok === true with lookupStatus: "not_found" is a completed lookup: the account doesn't exist. Retry the first kind; don't retry the second unless the handle changes.
References: Get Instagram profile · Get X profile · Get TikTok profile.
Her X profile's website points back to her YouTube channel, so that link runs both ways. A two-way link is the strongest evidence you'll get.
Step 4: fill the gaps carefully
Her YouTube channel doesn't link a TikTok account. Trying the handle she uses on Instagram, chloe_t, finds a verified TikTok account named Chloe Ting. That's a good match, but a weaker one than a declared link, so record how you made it.
Trying her YouTube handle instead finds the wrong people:

A simple rule for when to link an account automatically:
Send everything else to a person to check, with matchMethod: "manual" once they confirm it. Follower counts help them: an account with millions of followers on one platform and a few dozen on another is rarely the same creator, unless the creator says it's a new account.
Store one row per platform
Give each creator one parent record, and each of their accounts its own row:
| Column | Example | Where it comes from |
|---|---|---|
creatorId | crt_8f2a | your own ID |
platform | instagram | the route you called |
handle | chloe_t | the handle you looked up |
matchMethod | declared_link | your resolver: declared_link, exact_handle or manual |
lookupStatus | found | data.lookupStatus |
followers | 2301409 | the platform's follower field (see the table above) |
verified | true | verified on the account |
capturedAt | 2026-10-21T12:18:27Z | your clock when you stored it |
requestId | req_51161b0e-… | meta.requestId, for support if a number looks wrong |
creditsCharged | 1 | meta.creditsCharged, to add up costs per client |
Keep not_found and private rows too, with followers left empty, so you know you checked. If you add up a creator's total reach, decide in your code whether to count only found accounts. The API doesn't decide that for you.
Follower counts change, so look the accounts up again before a report or a campaign review rather than reusing an old import. A scheduled job that refreshes each row is enough; see the social listening guide for one way to set it up.
Recent posts for engagement checks
Follower counts get a creator onto a shortlist; recent posts show whether people watch. Once the accounts are linked, list recent posts for the ones you're still considering.
TikTok videos, newest first:
Instagram posts:
Each TikTok video has its counts in stats (views, likes, comments, shares, saves), and each Instagram post in metrics (likeCount, commentCount, playCount and so on). Both lists come back a page at a time; follow data.page.nextCursor while data.page.hasMore is true:
medianViews is null when no view counts are available. Missing or hidden counts are left out; an observed zero stays in the sample. For an even sample, the median averages the two middle counts.
A page or two is usually enough for vetting. Each page is a separate lookup with its own cost. For engagement rates done properly, see the engagement rate guide and the creator engagement scoring recipe.
References: TikTok profile videos · Instagram profile media.
Find creators to start from
If you don't have a list yet, search for creators by keyword. TikTok's user search returns profiles with their follower counts, so you can filter before looking anyone up on other platforms:
Store each handle with the query that found it, so you can run the same search again later. Remove duplicates before looking anyone up: the same creator can turn up in several searches. TikTok video search is another starting point when you care about what creators post more than what they're called.
Reference: Search TikTok users.
What it costs
Each of the four profile lookups costs 1 credit when it completes, including not_found and private results. Requests that fail, such as lookup_failed or temporarily_unavailable, aren't charged. Instagram's optional include=recentMedia and include=about add 1 credit each. Every response tells you what it cost in meta.creditsCharged, and the request log lists every lookup.

For one creator, the steps in this guide add up like this:
| Step | Lookups | Credits |
|---|---|---|
| The account you trust | 1 | 1 |
| Declared accounts (two in the example) | 2 | 2 |
| One handle you had to try | 1 | 1 |
| A page of recent TikTok videos | 1 | 1 |
| A page of recent Instagram posts | 1 | 1 |
| Total | 6 | 6 |
Most of the savings come from stopping early: if the first lookup is not_found, fix the handle before looking anywhere else, and read declared links before trying handles. See Credits for every route's price.
There's no rate limit on paid routes; your credit balance is the limit. There is a cap on how many requests a workspace can have in flight at once, and above it you get 503 temporarily_unavailable with reason: "concurrency_limit". Send large imports in batches rather than all at once. See Errors.
Troubleshooting
YouTube returns not_found, but the channel opens in a browser. Pass the address you see as url (for example https://www.youtube.com/@ChloeTing) instead of a handle, or pass the channelId. Older channels can have a custom address such as youtube.com/c/Name that isn't their handle.
An Instagram account is found, but the follower count is null. Check lookupStatus first: a private account returns what Instagram shows publicly, which may leave counts out. Also make sure you're reading data.profile.metrics.followers, not data.metrics.
An X handle made of digits finds the wrong account. The X route treats an all-digit value as a numeric user ID. Add by=handle to look it up as a handle.
A matching handle finds an account, but it's someone else. This is expected: a found result only means an account with that handle exists. Link it only if the name matches and the account is verified or links back, as in step 4.
The combined reach looks far too high. Two different people with the same handle have probably been merged. Keep accounts linked only by a handle match out of totals until someone confirms them, and don't count private or not_found rows.
lookup_failed (502) or temporarily_unavailable (503). These aren't charged. Wait for the Retry-After header if there is one, or back off and retry. If it keeps happening, contact support with the requestId.
A video or post list is empty for a found profile. The account may not have posted, or may only have pinned posts. Compare with the post count on the profile (data.metrics.posts on TikTok, data.profile.metrics.posts on Instagram) and check data.page.hasMore.