Douyin Hashtag API — Views and Accounts Posting
Documentation menu
FetchLayer FetchLayer API

Get a hashtag’s summary

A hashtag’s views and the number of accounts that have posted with it, by id or link. The videos under a hashtag are not available. 1 credit.

POST /hashtag-detail Trending & hashtags
https://api.fetchlayer.dev/douyin/hashtag-detail
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

hashtag string required

A hashtag id (digits, as in a video’s hashtags[].id) or a douyin.com/hashtag/... link.

format string optional

json or markdown, lowercase; any other value is a 400. Over MCP, markdown returns the result rendered as text; the REST API accepts it and returns JSON. (default: json)

timeoutMs integer optional

Time limit for the whole request, in milliseconds (1000–120000); a value outside that range is a 400. Where possible a partial answer comes back with a note; a request with nothing to return yet fails with a 503 you can retry, marked with the response header X-Timeout-Source: caller.

Response Fields

hashtag-detail

Get a hashtag’s summary

transport string

The data source: always the platform id, "douyin".

fetchedAt string

When the data was read (ISO 8601).

notes string[]

Caveats you can act on, such as older videos existing beyond the list. Empty when there are none.

hashtag.id string

The hashtag’s id.

hashtag.name string

Its name, without the #.

hashtag.description string | null

Its description.

hashtag.viewCount number

Views across its videos.

hashtag.userCount number

Accounts that have posted with it.

hashtag.coverUrl string | null

Cover image.

hashtag.url string

Link to it.

Request

curl -X POST "https://api.fetchlayer.dev/douyin/hashtag-detail" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"hashtag":"1587906243760205"}'

Response

{
  "transport": "douyin",
  "fetchedAt": "2026-10-15T15:54:17.269Z",
  "notes": [],
  "hashtag": {
    "id": "1587906243760205",
    "name": "这是我的世界",
    "description": null,
    "viewCount": 69706664,
    "userCount": 1826,
    "url": "https://www.douyin.com/hashtag/1587906243760205"
  }
}