TikTok Username to user ID API
Turn a TikTok handle, a profile link or a sec_uid into the numeric user_id and the sec_uid of the account, together with username and url, for $0.56 per 1,000 calls.
- It returns only the identifier fields
user_id,sec_uid,usernameandurl - It carries no profile data such as follower count or bio
- Failed calls and empty results are not charged.
API health
- 24h health
- Normal
- Healthy / normal
- Available
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "tiktok", "action": "resolve_user", "params": { "username": "nasa" } }2JSON response
{ "results": { "user_id": "", "username": "nasa", … } }3Fields
user_id username nasa 4CSV
tiktok-resolve_user-sample.csv user_id,sec_uid,username,url,platform
username goes in, and one JSON object with only identifier fields comes back: user_id, sec_uid, username and url, listed as a field table and a CSV file.What data you get
The table shows a real call for nasa, captured November 21, 2026 at 07:21 (UTC), that returned one object; gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.
| user_id | sec_uid | username | url | platform |
|---|---|---|---|---|
| nasa | https://www.tiktok.com/@nasa | tiktok |
Use cases
Turn handles in a list into IDs
Call once for each handle in a list and store
user_idandsec_uid, so you do not have to look them up again.Get the handle from a profile link
Pass a profile link and read
usernameto get the bare handle.Turn a `sec_uid` back into a handle
The
usernameparameter also takes asec_uid, and the returnedusernameandurlare the handle and profile link of that account.Then read the account profile
For follower counts and bio, pass
usernametoprofile.
Limits and gotchas
usernameis required: a handle (such as nasa, with or without @), the profile link https://www.tiktok.com/@<handle>, or thesec_uidof the account.- One call converts one account and returns one object.
- The response has no follower count, following count or bio. To read profile data, use
profile.
Pricing
You pay $0.000556 per call. One call reads one result. Failed calls and empty results are not charged.
| Calls | Cost |
|---|---|
| 10,000 | $5.56 |
| 100,000 | $55.56 |
| 1,000,000 | $555.56 |
Totals use the list price per call.
Code samples
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "tiktok",
"action": "resolve_user",
"params": {
"username": "nasa"
}
}'OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.
API reference
See the parameters, response fields, errors and billing for resolve_user, and copy the page or open it as Markdown for an AI assistant.
AI prompt
#Please help me write a data collection script with the EveryInfra TikTok Username to user ID endpoint (tiktok/resolve_user).
How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to tiktok and action to resolve_user, and put the parameters inside params.
- Required parameters:
- username: A TikTok username such as nasa (a leading @ is removed), a profile link, or the account's sec_uid.
- Returns one object. Main fields: user_id, sec_uid, username, url.
- Example request body:
{
"platform": "tiktok",
"action": "resolve_user",
"params": {
"username": "nasa"
}
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.
Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.Request parameters
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | tiktok | Platform identifier, fixed value. |
action | body | string | Yes | resolve_user | Capability identifier, fixed value. |
username | body.params | string | Yes | - | A TikTok username such as nasa (a leading @ is removed), a profile link, or the account's sec_uid. |
Response example
#{ "id": "req_…", "platform": "tiktok", "action": "resolve_user", "results": { "user_id": "•••", "sec_uid": "•••", "username": "nasa", "url": "https://www.tiktok.com/@nasa", "platform": "tiktok" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Response fields
#Business data is in results. The table lists the fields a record can contain. Values the platform does not show are never made up.
| Field | Meaning |
|---|---|
user_id | User's unique ID on the platform. |
sec_uid | Keeps the platform's own meaning |
username | Username (@handle). |
url | Link to the record on the platform. |
platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
Errors and billing
#- 401
- Missing or invalid key.
- 402
- Insufficient balance. Top up first.
- 422
- Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
- 429
- Per-minute request limit reached. Wait for Retry-After, then try again.
- 503
- Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
- 200 empty
- No data. No charge.
FAQ
What does the handle-to-ID API return?
One object: user_id, sec_uid, username and url.
Which endpoint reads follower counts and bio?
Use profile for the account profile, and followers when you only need the follower count. This endpoint only converts identifiers.
How much does it cost to convert one account?
It costs $0.000556 per call, or $0.56 per 1,000 calls. One call reads one result. Failed calls and empty results are not charged.
Related TikTok endpoints
You can call the other TikTok endpoints with the same EveryInfra API key, for example profile.
- Search
search$0.56 per 1,000 callsSearch TikTok by keyword across the video, account or top tab. - Details
profile$0.56 per 1,000 callsLook up a TikTok account by handle. - Videos by user
user_videos$0.56 per 1,000 callsList a TikTok creator's videos with caption, publish time and like, comment, share and view counts. - Video details
video$0.56 per 1,000 callsFetch one TikTok video's caption, author, publish time and like, comment, share and view counts from its URL. - Comments
comments$0.56 per 1,000 callsRead the comments on a TikTok video. - Hashtag
hashtag$0.56 per 1,000 callsBrowse TikTok videos posted under a hashtag. - Followers
followers$0.56 per 1,000 callsCheck a TikTok account's follower, following, post and like totals by handle, with a precision flag for rounded numbers. - Transcript
transcript$0.56 per 1,000 callsExtract the transcript of a TikTok video from its URL. - Shop product search
shop_search$0.56 per 1,000 callsFind TikTok Shop products by keyword. - Shop creator details
shop_creator$0.56 per 1,000 callsSize up a TikTok Shop creator by handle. - Hashtag search
hashtag_search$0.81 per 1,000 callsSearch TikTok hashtags bykeyword. - Music search
music_search$0.81 per 1,000 callsSearch TikTok's sound library bykeyword, such as a song or artist. - Music chart
music_chart$0.81 per 1,000 callsRead a TikTok music chart:top50(default) orviral50. - Account search
user_search$0.56 per 1,000 callsSearch TikTok accounts bykeyword, in the order TikTok search ranks them. - Videos using a sound
sound_videos$0.56 per 1,000 callsList the TikTok videos that use one sound, from itsmusic_idor sound page link. - Comment replies
comment_replies$0.56 per 1,000 callsRead the replies under one comment on a TikTok video, from the videourland the comment'sidreturned bycomments. - Shop best sellers
shop_hot_products$0.81 per 1,000 callsRead the TikTok Shop best-seller list for one market: ID, JP, MX, MY (default), PH, SG, TH or VN. - Shop products by category
shop_category_products$0.81 per 1,000 callsList TikTok Shop products in one category bycategory_id, such as 601450 for beauty and personal care, in a chosen market. - Following
following$0.64 per 1,000 callsList the accounts a TikTok user follows, by handle. - Video download links
video_download$0.64 per 1,000 callsGet the download links for one TikTok video from itsurl, without the watermark. - Live room
live_room$0.81 per 1,000 callsCheck whether a TikTok account is live right now, by handle. - Shop store products
shop_products$0.81 per 1,000 callsList the products of one TikTok Shop store from itsshop_idor store link, in a chosen market. - Shop product reviews
shop_product_reviews$0.76 per 1,000 callsRead buyer reviews of one TikTok Shop product from itsproduct_idor product link. - Trending hashtags
trending_hashtags$0.81 per 1,000 callsRead the trending hashtags on TikTok for one market over the last 7, 30 or 90 days, optionally for one industry. - Link recognition
resolve_links$0.56 per 1,000 callsRead the video ID from one TikTok link inurl, including vm.tiktok.com and vt.tiktok.com share links. - Hashtag detail
hashtag_detail$0.56 per 1,000 callsRead one TikTok hashtag fromhashtag(its name, with or without #, a tag link or the numeric ID):hashtag_id,hashtag_name,url, exactvideo_countandview_count, andis_commercial. - Music detail
music_detail$0.56 per 1,000 callsRead one TikTok sound bymusic_idor music link:title,author_name,album,duration_seconds, how many videos use it (use_count),is_original,is_copyrighted, a cover link and a preview audio link that expires.