TikTok Hashtag detail API

Read the details of one TikTok hashtag from its name, link or numeric ID in hashtag: hashtag_id, video_count, view_count and is_commercial, for $0.56 per 1,000 calls.

  • hashtag takes a name, a /tag/ link or a numeric ID
  • Returns the totals, not the videos under the tag
  • A hashtag with an announcement returns the notice from the top of its page

API health

24h health
Normal
  • Healthy / normal
  • Available
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "tiktok",
      "action": "hashtag_detail",
      "params": {
        "hashtag": "fyp"
      }
    }
  2. 2JSON response

    {
      "results": {
        "hashtag_id": "229207",
        "hashtag_name": "fyp",
        "video_count": 9551698607,
        "view_count": 132213607992265,
        …
      }
    }
  3. 3Fields

    hashtag_idhashtag_namevideo_countview_count
    229207fyp9551698607132213607992265
  4. 4CSV

    tiktok-hashtag_detail-sample.csv hashtag_id,hashtag_name,url,description,video_count,view_count,cover_image_url,is_commercial,announcement,platform

A request with hashtag goes in, and one JSON object comes back with hashtag_id, video_count, view_count and more, listed as a field table and a CSV file.

What data you get

The table shows a real call for fyp, captured November 21, 2026 at 07:21 (UTC), that returned one object. Your own calls return the fields listed in the field reference.

hashtag_idhashtag_nameurldescriptionvideo_countview_countcover_image_urlis_commercialannouncementplatform
229207fyphttps://www.tiktok.com/tag/fypnull9551698607132213607992265nullnullnulltiktok

Use cases

  • Record the size of a tag over time

    Read video_count and view_count at set intervals and subtract to get the change.

  • Keep the tag page's summary and cover

    description and cover_image_url come back only when the tag page has them. Store them with hashtag_id when you get them.

  • Read the notice on a tag page

    announcement is the notice at the top of the hashtag page. It is returned only when the tag has one.

  • Turn a tag name into an ID

    Read the tag once by name or link, keep the hashtag_id, and store records by ID after that.

Limits and gotchas

  • hashtag is required: a hashtag name (for example nasa, with or without #), a link like https://www.tiktok.com/tag/<name>, or a numeric hashtag ID.
  • One call reads one hashtag and returns one object.
  • description, announcement and cover_image_url are returned only when the hashtag page has them.
  • This page reads the totals of the hashtag, not the videos under it. Use hashtag for the videos.

Pricing

You pay $0.000556 per call, and one call reads one hashtag. 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": "hashtag_detail",
  "params": {
    "hashtag": "fyp"
  }
}'

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 hashtag_detail, 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 Hashtag detail endpoint (tiktok/hashtag_detail).

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 hashtag_detail, and put the parameters inside params.
- Required parameters:
  - hashtag: A hashtag name such as nasa (a leading # is removed), a https://www.tiktok.com/tag/<name> link, or a numeric hashtag ID.
- Returns one object. Main fields: hashtag_id, hashtag_name, url, description, video_count, view_count, cover_image_url, is_commercial, announcement.
- Example request body:
{
  "platform": "tiktok",
  "action": "hashtag_detail",
  "params": {
    "hashtag": "fyp"
  }
}
- 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.
actionbodystringYeshashtag_detailCapability identifier, fixed value.
hashtagbody.paramsstringYes-A hashtag name such as nasa (a leading # is removed), a https://www.tiktok.com/tag/<name> link, or a numeric hashtag ID.

Response example

#
Captured November 21, 2026 at 07:21 (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": "hashtag_detail",  "results": {    "hashtag_id": "229207",    "hashtag_name": "fyp",    "url": "https://www.tiktok.com/tag/fyp",    "video_count": 9551698607,    "view_count": 132213607992265,    "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
hashtag_idKeeps the platform's own meaning
hashtag_nameKeeps the platform's own meaning
urlLink to the record on the platform.
descriptionSummary or description, usually shorter than text.
video_countKeeps the platform's own meaning
view_countViews or plays. null means not disclosed, not 0.
cover_image_urlKeeps the platform's own meaning
is_commercialKeeps the platform's own meaning
announcementKeeps the platform's own meaning
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 TikTok hashtag details API return?

One object: hashtag_id, hashtag_name, url, video_count, view_count and is_commercial. When the hashtag page has them, it also returns description, announcement and cover_image_url.

How much does it cost to read one hashtag?

It costs $0.000556 per call, or $0.56 per 1,000 calls. One call reads one hashtag. Failed calls and empty results are not charged.

What can I put in hashtag?

A hashtag name, with or without the #, a link like https://www.tiktok.com/tag/<name>, or a numeric hashtag ID.

How do hashtag_detail, hashtag_search and hashtag differ?

hashtag_detail reads the totals of one known hashtag, hashtag_search finds hashtags by keyword, and hashtag reads the videos under a hashtag.

You can call the other TikTok endpoints with the same key, such as hashtag for the videos under this hashtag, or hashtag_search to find similar hashtags.

Google Analytics needs consent. Privacy