← All articles
November 1, 2026 · 7 min read

How to Turn a List of TikTok Handles Into Recruiting Data With an API

A developer guide to enriching a raw list of TikTok usernames: how to resolve each handle to a real profile, check who is live right now, and filter a spreadsheet of names down to a recruiting shortlist with a single API call per handle.

Most recruiting pipelines start with a list of names. A scout sends over a spreadsheet of TikTok handles, a manager pastes a column of usernames from a group chat, or an old export gets dusted off to see who is still worth contacting. The problem is that a bare list of handles is almost worthless on its own. You cannot tell which accounts still exist, which ones have a real audience, and which creator is streaming right now while your team sits on the information. This guide walks through how to turn that raw list into usable recruiting data from code, one handle at a time, without scraping the app yourself.

What a list of handles does not tell you

A username is just a string. It does not say whether the account is active, whether the handle was typed correctly, or whether the person behind it is the creator you think they are. Work a list manually and you waste hours opening profiles one by one, and you still miss the thing that matters most in LIVE recruiting: timing. A creator is far easier to reach and far more receptive while they are actually live than when their room is dark. By the time a human has checked a handle in the app, that window may already have closed. The goal of enriching a list programmatically is to answer, for every name at once, three questions: is this a real profile, who is it, and are they live right now.

The one call that does the work

You do not need a separate request for each of those questions. A live lookup endpoint resolves a single handle to a full answer in one round trip. Using the RnG API as a concrete example, a lookup is a plain GET with your key in a header:

curl "https://rngrow.com/api/v1/creators/resolve?username=somehandle" \
  -H "X-API-Key: rng_live_YOUR_KEY"

The handle works with or without the leading @, so you do not have to strip it yourself. The response tells you whether the profile was found and, if so, who it is:

{
  "found": true,
  "creator": {
    "username": "somehandle",
    "nickname": "Creator Name",
    "avatar": "https://p16-common-sign.tiktokcdn-eu.com/...",
    "verified": false,
    "follower_count": 152300,
    "live": true
  }
}

One important detail about the live field: a trustworthy lookup reads live status from the room's own state, not from a stale room id or a cached listing. A stream that just ended should read as offline, not linger as live for several minutes. If you are going to act on a green light, make sure the green light is honest, because acting on a creator who went dark five minutes ago is worse than not checking at all.

Reading the answer

Once you have the JSON, each field maps to a decision your pipeline can make automatically:

  • found: false means the handle is wrong, the account was renamed, or it no longer exists. Drop it from the list or flag it for a human to re-check, but do not keep retrying it.
  • follower_count lets you sort a raw list into tiers before anyone spends time on outreach. A handle with a few hundred followers and one with a hundred thousand do not deserve the same priority.
  • live: true is the time-sensitive signal. Route these to the front of the queue so a manager can watch the room and reach out while the creator is on.
  • nickname and avatar give you a display name and picture to show in your own dashboard, so your team recognizes a creator at a glance instead of staring at a bare handle.

Processing a whole list without getting blocked

Running one lookup is easy. Running a few thousand in a loop is where people get themselves rate limited. A few habits keep a batch job polite and cheap:

  • Normalize and deduplicate first. Lowercase every handle, strip the @ and any surrounding whitespace, and remove duplicates before you make a single request. Spreadsheets are full of the same name twice.
  • Stay inside the per-minute budget. The API caps requests per minute and per day and returns 429 with a Retry-After header when you go over. Read that header and pause for exactly as long as it asks, rather than hammering and hoping.
  • Cache profile facts, re-check live status. A follower count or nickname barely moves hour to hour, so cache it. Live status is the opposite: it is only true in the moment, so never trust a cached value for it. Split the two so you are not re-fetching stable fields just to learn whether a room is open.

From validated handles to a shortlist

The point of all this is not the data, it is the shortlist it produces. After a batch run you can throw away the dead handles, sort the survivors by follower tier, and surface the ones who are live right now at the top of a manager's screen. That turns a passive spreadsheet into a working queue: instead of someone deciding which name to open next, the pipeline hands them the creators most worth contacting, in order, with the live ones first. From there the same records feed naturally into whatever you already use, whether that is a CRM, an outreach tool, or a message sent through Auto-Messenger while the creator is still on.

A word of caution on the handles themselves: treat them as untrusted input. A list from a scout will contain typos, display names pasted in place of usernames, and the occasional link instead of a handle. Resolving each one is also how you clean the list, because a found: false is a data-quality signal, not just a miss.

The takeaway

A list of TikTok handles is raw material, not a lead list. One resolve call per handle turns it into something your team can act on: real profiles instead of guesses, follower tiers instead of a flat column, and a live-right-now flag that tells a manager exactly when to reach out. Normalize the list, respect the rate limit, cache what is stable and re-check what is not, and you can enrich thousands of names on a schedule without ever opening the app. The names were always the easy part. The value is in knowing, for each one, whether it is worth a message and whether now is the moment to send it.

Stop searching. Start recruiting.

RnG scans TikTok LIVE 24/7 and delivers recruitable creators to your dashboard.

See plans
RnG

Still loading, slow connection. Tap to reload