TikTok Link recognition API
Turn one TikTok post link, including share short links such as vm.tiktok.com and vt.tiktok.com, into the post id, the canonical url and the author handle author_username, for $0.56 per 1,000 calls.
- Full links, /photo/ links and share short links are all accepted
- One link per call
- 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_links", "params": { "url": "https://www.tiktok.com/@stoolpresidente/video/7488736374602927402" } }2JSON response
{ "results": { … } }3Fields
4CSV
tiktok-resolve_links-sample.csv id,url,platform
url goes in, and one JSON object comes back: id, url and author_username, listed as a field table and a CSV file.What data you get
The table shows a real call for tiktok.com/@stoolpresidente/video/7488736374602927402, captured November 22, 2026 at 06:29 (UTC), that returned one object. Your own calls return these fields as listed in the field reference.
| id | url | platform |
|---|---|---|
| 7488736374602927402 | https://www.tiktok.com/@/video/7488736374602927402 | tiktok |
Use cases
Expand a share short link
Pass a vm.tiktok.com or vt.tiktok.com short link and read
urlto get the canonical link.Deduplicate by post ID
Links written in different ways that give the same
idpoint to the same post, so you can deduplicate onid.Get the author handle
Read
author_usernameand pass it toprofileoruser_videos.Clean up a batch of links
One call takes one link, so call once per link and store
idandurlas two columns.
TikTok for Developers vs EveryInfra
How the TikTok developer documentation on oEmbed and EveryInfra resolve_links compare on what one link gives you:
| Compared | TikTok for Developers | EveryInfra |
|---|---|---|
| From a link to video data | "Programmatically, you may convert a TikTok's video URL into embedded video markup by using the oEmbed API." | url takes one post link and returns the post id, the canonical url and the author handle author_username. |
| What comes back | "It allows you to get the embed code and additional information about the video associated with the webpage link provided." | It also starts from one link, and what comes back is the post ID and the author handle, not an embed code. |
The quotes come from the Embedding TikTok Videos page of TikTok for Developers. The page shows no update date, and we checked it on 2026-11-22. Its example uses a full video link and does not cover share short links. Official sources: Embedding TikTok Videos: A Comprehensive Guide
Limits and gotchas
urlis required, one per call: a full link https://www.tiktok.com/@user/video/<digits> (and /photo/<digits> for photo posts), or a share short link such as vm.tiktok.com or vt.tiktok.com.- The response is one object with only
id,urlandauthor_username. It carries no caption or play count. To read the video itself, usevideo. idis the post ID,urlis the canonical link andauthor_usernameis the author handle.
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_links",
"params": {
"url": "https://www.tiktok.com/@stoolpresidente/video/7488736374602927402"
}
}'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_links, 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 Link recognition endpoint (tiktok/resolve_links).
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_links, and put the parameters inside params.
- Required parameters:
- url: One TikTok link: a full video or photo post link (/video/ or /photo/), or a vm.tiktok.com or vt.tiktok.com share link.
- Returns one object. Main fields: id, url.
- Example request body:
{
"platform": "tiktok",
"action": "resolve_links",
"params": {
"url": "https://www.tiktok.com/@stoolpresidente/video/7488736374602927402"
}
}
- 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_links | Capability identifier, fixed value. |
url | body.params | string | Yes | - | One TikTok link: a full video or photo post link (/video/ or /photo/), or a vm.tiktok.com or vt.tiktok.com share link. |
Response example
#{ "id": "req_…", "platform": "tiktok", "action": "resolve_links", "results": { "id": "7488736374602927402", "url": "https://www.tiktok.com/@/video/7488736374602927402", "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 |
|---|---|
id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
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 link recognition API return?
One object: id (the post ID), url (the canonical link) and author_username (the author handle).
What can I do once I have the canonical link?
Pass url to video for the details, comments for the comments, or video_download for the download link.
How much does it cost to recognize one link?
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 video.
- 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. - Username to user ID
resolve_user$0.56 per 1,000 callsTurn a TikTokusername(with or without @), a profile link or asec_uidinto the account's numericuser_id, itssec_uid, currentusernameand profileurl. - 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.