Douyin Post metrics history API

Read the recorded snapshots of likes, comments, shares and saves of one post by its video ID or video link; each row has its own captured_at, for $0.79 per 1,000 calls.

  • Rows run from earliest to latest, and the gaps between records vary.
  • It takes a video ID or a video link, not a short link or a share text.
  • Failed calls and empty results are not charged.

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "douyin",
      "action": "post_history",
      "params": {
        "url": "https://www.douyin.com/video/7633646113853104116"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "video_id": string,
          "captured_at": …,
          "like_count": number,
          "comment_count": number
        },
        …
      ]
    }
  3. 3Rows

    video_idcaptured_atlike_countcomment_count
    string…numbernumber
  4. 4CSV

    douyin-post_history-sample.csv video_id,captured_at,like_count,comment_count,share_count,collect_count,platform

A request with url goes in, and the records of the post come back; each row in results holds the four counts at one moment, listed as a field table and a CSV file.

What data you get

This endpoint has no public real sample yet. The table lists the fields, types and meanings that each row returns, with no values.

FieldTypeMeaning
video_idstringID of the video: on comments, the video the comment belongs to; on post_history, the video you asked about.
captured_at—When this snapshot of the video's counts was recorded (post_history, ISO 8601, UTC); rows run from oldest to newest, at irregular intervals.
like_countnumberLikes. null means the platform or this capability does not disclose it; it is not 0.
comment_countnumberComments. null means not disclosed, not 0.
share_countnumberShares. null means not disclosed, not 0.
collect_countnumberSaves or favorites. null means not disclosed, not 0.
platformstringSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

Use cases

  • Draw the engagement curve of a post

    Sort by captured_at and plot like_count, comment_count, share_count and collect_count as lines to see where the growth happened.

  • Review a promoted video

    Compare like_count and collect_count at each record after publishing to see in which period engagement bunched up.

  • Compare the trend of two posts

    Read each post once, line the rows up by captured_at and compare how each one grew.

  • Add the change that a batch read lacks

    posts_batch gives the engagement counts at the moment of the read; use this endpoint to see the change.

Douyin Open Platform vs EveryInfra

Here is how the Douyin Open Platform overall authorization guide and EveryInfra post_history compare on access.

ComparedDouyin Open PlatformEveryInfra
App credentialsThe documentation says the third party sends the code, together with ClientKey and ClientSecret, to an API to get an access_token.You need no ClientKey or ClientSecret to get a credential. The header carries your EveryInfra API key and the request carries only url.

The Douyin Open Platform documentation is in Chinese; the table shows a translation, checked against its overall authorization guide on 2026-11-22. The page shows no update date. The documentation has no description of historical snapshots of a post's numbers, so only access is compared here. Official sources: Overall authorization guide

Limits and gotchas

  • url is required: a numeric video ID, or a video link that contains that ID. Short links and share texts are not accepted.
  • Each row is one record, and captured_at is the time of the record; rows run from earliest to latest, and the gaps between records vary.
  • Some posts have very few records or none.
  • One call returns the whole set of records, with no paging.
  • The four counts are the values at the moment of the record.

Pricing

Each call costs $0.000792 and is billed per call, not per record; one call returns the whole set of records. Failed calls and empty results are not charged.

CallsCost
10,000$7.92
100,000$79.17
1,000,000$791.67

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": "douyin",
  "action": "post_history",
  "params": {
    "url": "https://www.douyin.com/video/7633646113853104116"
  }
}'

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 post_history, 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 Douyin Post metrics history endpoint (douyin/post_history).

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 douyin and action to post_history, and put the parameters inside params.
- Required parameters:
  - url: The Douyin video whose like, comment, share and collect snapshots you want: a numeric video ID, or a link that contains it such as https://www.douyin.com/video/<video_id>. Short links and share texts are not accepted.
- Optional parameters:
  - limit: The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows.
- Returns a list of records. Main fields of each record: video_id (ID of the video: on comments, the video…), captured_at (When this snapshot of the video's count…), like_count, comment_count, share_count, collect_count.
- Example request body:
{
  "platform": "douyin",
  "action": "post_history",
  "params": {
    "url": "https://www.douyin.com/video/7633646113853104116"
  }
}
- Price: $0.79 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.
platformbodystringYesdouyinPlatform identifier, fixed value.
actionbodystringYespost_historyCapability identifier, fixed value.
urlbody.paramsstringYes-The Douyin video whose like, comment, share and collect snapshots you want: a numeric video ID, or a link that contains it such as https://www.douyin.com/video/<video_id>. Short links and share texts are not accepted.
limitbody.paramsinteger (1–)No-The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows.

Response example

#
No sample response is available for these parameters yet. This preview shows the response shape and fields from the API definition, with … as placeholders; it is not the result of a live call.
json
{  "id": "req_…",  "platform": "douyin",  "action": "post_history",  "results": [    {      "video_id": …,      "captured_at": …,      "like_count": …,      "comment_count": …,      "share_count": …,      "collect_count": …,      "platform": …    }  ],  "count": …,  "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
video_idID of the video: on comments, the video the comment belongs to; on post_history, the video you asked about.
captured_atWhen this snapshot of the video's counts was recorded (post_history, ISO 8601, UTC); rows run from oldest to newest, at irregular intervals.
like_countLikes. null means the platform or this capability does not disclose it; it is not 0.
comment_countComments. null means not disclosed, not 0.
share_countShares. null means not disclosed, not 0.
collect_countSaves or favorites. null means not disclosed, not 0.
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 post history API return?

The snapshots recorded for the post, one record per row: video_id, captured_at, like_count, comment_count, share_count and collect_count.

Are the records evenly spaced in time?

No. Rows are sorted by captured_at from earliest to latest, the gaps are long or short, and some posts have very few records or none.

Can I pass a v.douyin.com short link?

No. It takes only a numeric video ID or a video link that contains that ID; short links and share texts are not accepted.

How much does it cost to read the records?

It costs $0.000792 per call, or $0.79 per 1,000 calls, billed per call and not per record. Failed calls and empty results are not charged.

You can call the other Douyin endpoints with the same EveryInfra API key.

Google Analytics needs consent. Privacy