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.
hashtagtakes a name, a/tag/link or a numeric ID- Returns the totals, not the videos under the tag
- A hashtag with an
announcementreturns the notice from the top of its page
API health
- 24h health
- Normal
- Healthy / normal
- Available
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "tiktok", "action": "hashtag_detail", "params": { "hashtag": "fyp" } }2JSON response
{ "results": { "hashtag_id": "229207", "hashtag_name": "fyp", "video_count": 9551698607, "view_count": 132213607992265, … } }3Fields
hashtag_id hashtag_name video_count view_count 229207 fyp 9551698607 132213607992265 4CSV
tiktok-hashtag_detail-sample.csv hashtag_id,hashtag_name,url,description,video_count,view_count,cover_image_url,is_commercial,announcement,platform
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_id | hashtag_name | url | description | video_count | view_count | cover_image_url | is_commercial | announcement | platform |
|---|---|---|---|---|---|---|---|---|---|
| 229207 | fyp | https://www.tiktok.com/tag/fyp | null | 9551698607 | 132213607992265 | null | null | null | tiktok |
Use cases
Record the size of a tag over time
Read
video_countandview_countat set intervals and subtract to get the change.Keep the tag page's summary and cover
descriptionandcover_image_urlcome back only when the tag page has them. Store them withhashtag_idwhen you get them.Read the notice on a tag page
announcementis 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
hashtagis required: a hashtag name (for example nasa, with or without #), a link likehttps://www.tiktok.com/tag/<name>, or a numeric hashtag ID.- One call reads one hashtag and returns one object.
description,announcementandcover_image_urlare returned only when the hashtag page has them.- This page reads the totals of the hashtag, not the videos under it. Use
hashtagfor the videos.
Pricing
You pay $0.000556 per call, and one call reads one hashtag. 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": "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.
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
#| 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 | hashtag_detail | Capability identifier, fixed value. |
hashtag | body.params | string | Yes | - | 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
#{ "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.
| Field | Meaning |
|---|---|
hashtag_id | Keeps the platform's own meaning |
hashtag_name | Keeps the platform's own meaning |
url | Link to the record on the platform. |
description | Summary or description, usually shorter than text. |
video_count | Keeps the platform's own meaning |
view_count | Views or plays. null means not disclosed, not 0. |
cover_image_url | Keeps the platform's own meaning |
is_commercial | Keeps the platform's own meaning |
announcement | Keeps the platform's own meaning |
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 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.
Related TikTok endpoints
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.
- 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. - 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. - 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.