Douyin hashtag videos API
Douyin videos under a hashtag (challenge) ID, newest or hottest first
Use the Douyin hashtag videos API to read public Douyin hashtag_videos. Douyin videos under a hashtag (challenge) ID, newest or hottest first.
Request
Send your API key as a Bearer token. Replace YOUR_API_KEY with a key from your console.
curl "https://xtikapi.com/v1/douyin/hashtag_videos/list?ch_id=example" \
-H "Authorization: Bearer YOUR_API_KEY"import requests
response = requests.get(
"https://xtikapi.com/v1/douyin/hashtag_videos/list",
params={"ch_id":"example"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const response = await fetch("https://xtikapi.com/v1/douyin/hashtag_videos/list?ch_id=example", {
headers: { Authorization: "Bearer YOUR_API_KEY" },
});
console.log(await response.json());Parameters
| Name | Type | Required |
|---|---|---|
| ch_id | string | required |
| cursor | number | optional |
| sort | number | optional |
| limit | number | optional |
Response fields
Every platform returns the same post shape. A field the platform does not provide is named in meta.unavailable.
- id
- url
- text
- author
- createdAt
- likeCount
- commentCount
- shareCount
- viewCount
- cover
Example response
Recorded from a live call on 2026-11-18. Names, text, links and images are replaced with examples; counts, dates and field names are real.
{
"data": {
"items": [
{
"id": "3074185296307418529",
"url": "https://example.com/link",
"text": "Example text",
"author": {
"id": "xx7xxxxxxxxxxxx8xxxxxxxxx85xxxxxx4xxxxx-xxxxxxx2xx_xxxxx5xxxx0xxxxxxxx3xxx_8",
"username": "example_user",
"name": "Example name",
"avatar": "https://example.com/image.jpg",
"followers": 0,
"description": "Example text"
},
"createdAt": "2022-03-30T05:30:24.000Z",
"likeCount": 2768788,
"commentCount": 103572,
"shareCount": 189403,
"cover": "https://example.com/image.jpg"
},
{
"id": "3074185296307418529",
"url": "https://example.com/link",
"text": "Example text",
"author": {
"id": "xx7xxxxxxxxxxxxxxxxxxxxxxx5xxxxxxxxxxx9x3xxxxxxxxxxxxxx",
"username": "example_user",
"name": "Example name",
"avatar": "https://example.com/image.jpg",
"followers": 0,
"description": "Example text"
},
"createdAt": "2025-07-12T02:21:31.000Z",
"likeCount": 2632785,
"commentCount": 162483,
"shareCount": 1049821,
"cover": "https://example.com/image.jpg"
}
]
},
"meta": {
"request_id": "example",
"endpoint": "douyin.hashtag_videos.list",
"normalized": true,
"unavailable": [
"viewCount"
],
"billing": {
"charged": true,
"amount": 0.002,
"balance": 4.98
}
}
}Error codes
Errors are not billed. Retry the ones marked yes. More in the API quickstart.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
| unauthorized | 401 | no | API key is missing, invalid, or revoked. |
| rate_limited | 429 | yes | Too many requests. |
| invalid_params | 422 | no | Request parameters are invalid. |
| price_exceeds_max | 402 | no | This call costs more than X-Max-Price. |
| insufficient_balance | 402 | no | Balance is too low for this call. |
| key_limit_reached | 402 | no | This API key has reached its spend limit. |
| idempotency_conflict | 409 | no | This Idempotency-Key was already used with different parameters. |
| idempotency_in_progress | 409 | yes | A request with this Idempotency-Key is still running. |
| response_too_large | 409 | no | The response is too large to store for a safe retry. |
| upstream_error | 502 | yes | The data provider returned an error. You were not charged. |
| upstream_timeout | 504 | yes | The data provider timed out. You were not charged. |
| internal_error | 500 | yes | Something went wrong on our side. You were not charged. |
| not_found | 404 | no | No such endpoint. |
Same call on other platforms
Change the platform word in the path. The request and the response shape stay the same.
More Douyin APIs
- Douyin video search API→
- Douyin video details API→
- Douyin comments API→
- Douyin account details API→
- Douyin video list API→
- Douyin trending topics API→
- Douyin comment replies API→
- Douyin hashtag details API→
- Douyin music videos API→
- Douyin account search API→
- Douyin video play count API→
- Douyin related videos API→
- Douyin trending videos API→
- Douyin viral videos from small accounts API→
- Douyin search suggestions API→
- Douyin follower trend API→
- Douyin account followers API→
- Douyin uid to sec_uid API→
- Douyin video ID from link API→
- Douyin sec_uid from profile link API→
- Douyin rising hot list API→
- Douyin music chart API→
- Douyin brand hot list API→
- Douyin keyword trend index API→
- Douyin related keywords API→
- Douyin keyword audience API→
- Douyin trend index hot topics API→
- Douyin trend index hot videos API→
- Douyin brand trend API→
- Douyin brand comparison API→
- Douyin creator metrics API→
- Douyin creator audience API→
- Douyin creator top videos API→
Questions
What does the Douyin hashtag videos API return?
A post object with the fields listed on this page. Missing provider fields are named in meta.unavailable.
When is the Douyin hashtag videos API billed?
This call costs $0.002 when the provider returns HTTP 200. An empty result is billed. Errors and timeouts are not billed.
What do I do if the provider returns an error?
The response has charged set to false. Read the error code and retry if the error says retry is true. Your balance is unchanged.
Where is this resource on another platform?
Use the links on this page for the same resource and action on other platforms. Change the platform word in the path.