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
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "tiktok",
      "action": "resolve_links",
      "params": {
        "url": "https://www.tiktok.com/@stoolpresidente/video/7488736374602927402"
      }
    }
  2. 2JSON response

    {
      "results": {
        …
      }
    }
  3. 3Fields

  4. 4CSV

    tiktok-resolve_links-sample.csv id,url,platform

A request with one post link in 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.

idurlplatform
7488736374602927402https://www.tiktok.com/@/video/7488736374602927402tiktok

Use cases

  • Expand a share short link

    Pass a vm.tiktok.com or vt.tiktok.com short link and read url to get the canonical link.

  • Deduplicate by post ID

    Links written in different ways that give the same id point to the same post, so you can deduplicate on id.

  • Get the author handle

    Read author_username and pass it to profile or user_videos.

  • Clean up a batch of links

    One call takes one link, so call once per link and store id and url as 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:

ComparedTikTok for DevelopersEveryInfra
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

  • url is 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, url and author_username. It carries no caption or play count. To read the video itself, use video.
  • id is the post ID, url is the canonical link and author_username is the author handle.

Pricing

You pay $0.000556 per call. One call reads one result. Failed calls and empty results are not charged.

CallsCost
10,000$5.56
100,000$55.56
1,000,000$555.56

Totals use the list price per call.

Code samples

#
bash
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.

POST

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

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYestiktokPlatform identifier, fixed value.
actionbodystringYesresolve_linksCapability identifier, fixed value.
urlbody.paramsstringYes-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

#
Captured November 22, 2026 at 06:29 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed. id, billing and quota differ on every call, so only their shape is shown.
json
{  "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.

FieldMeaning
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
urlLink to the record on the platform.
platformSource 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.

Errors

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.

You can call the other TikTok endpoints with the same EveryInfra API key, for example video.

Google Analytics needs consent. Privacy