General

Cross-platform creator profiles with one API (2026)

Find the same creator on YouTube, Instagram, X and TikTok, link the right accounts, and store their follower counts as one record, with one API key.

Social FetchUpdated

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:

  1. Look up the account you trust most.
  2. Read the links on it.
  3. Look up the accounts those links name.
  4. 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:

PlatformFollowersLinks the creator added
YouTubedata.metrics.subscribersdata.channel.externalLinks
Instagramdata.profile.metrics.followersdata.profile.bioLinks, data.profile.externalUrl
Xdata.metrics.followersdata.profile.website
TikTokdata.metrics.followersdata.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.

The Social Fetch Playground after an Instagram profile lookup for chloe_t. The JSON response is scrolled to the profile's metrics object, and the followers line is boxed with the label 'Instagram puts metrics inside profile'.
Instagram's counts sit inside data.profile.metrics. On YouTube, X and TikTok they're in data.metrics.

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.

Request
bash

The same lookup with the SDK:

Request
typescript

Reference: Get YouTube channel.

The channel's externalLinks list everything Chloe Ting added to her channel, including her Instagram and X accounts.

The Social Fetch Playground after a YouTube channel lookup with the handle ChloeTing. The response is scrolled to externalLinks; the instagram.com/chloe_t line is boxed with the label 'Her Instagram, declared by the creator', and the twitter.com/chloe_ting line with 'Her X account'.
externalLinks names her Instagram and X accounts, whose handles differ from her YouTube one.

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:

Request
typescript

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:

Request
typescript

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 table built from a real run of this guide's code. Four rows for Chloe Ting: youtube ChloeTing (anchor), instagram chloe_t and twitter chloe_ting (declared_link), and tiktok chloe_t (exact_handle), each found, with follower counts and 1 credit each. Two greyed rows below, for twitter and tiktok with the same handle as YouTube, are found but marked 'not linked', with a few dozen followers each. A box around them is labelled 'Same handle as YouTube, but different people'.
The same handle as her YouTube channel finds an account on X and TikTok, but not hers. Both still cost a credit.

A simple rule for when to link an account automatically:

Request
typescript

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:

ColumnExampleWhere it comes from
creatorIdcrt_8f2ayour own ID
platforminstagramthe route you called
handlechloe_tthe handle you looked up
matchMethoddeclared_linkyour resolver: declared_link, exact_handle or manual
lookupStatusfounddata.lookupStatus
followers2301409the platform's follower field (see the table above)
verifiedtrueverified on the account
capturedAt2026-10-21T12:18:27Zyour clock when you stored it
requestIdreq_51161b0e-…meta.requestId, for support if a number looks wrong
creditsCharged1meta.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:

Request
bash

Instagram posts:

Request
bash

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:

Request
typescript

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:

Request
bash
Request
typescript

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.

The Request history page in the Social Fetch app, filtered to paths containing 'chlo'. Five lookups made together are highlighted: TikTok and X lookups for the guessed handle, then TikTok chloe_t, Instagram chloe_t and X chloe_ting, each with status 200 and 1 credit. The two guessed paths are boxed with the label 'Wrong guesses: still 1 credit each'. Their identifying suffixes are covered in both the highlighted rows and the repeated dimmed rows below.
The request log shows every lookup and its cost. Guessing handles that turn out wrong still costs credits.

For one creator, the steps in this guide add up like this:

StepLookupsCredits
The account you trust11
Declared accounts (two in the example)22
One handle you had to try11
A page of recent TikTok videos11
A page of recent Instagram posts11
Total66

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.

Share this article