TikTok Hashtag Feed API: Find Videos by Challenge Name

Retrieve the media feed associated with a TikTok challenge, also called a hashtag, using the required challenge_name path value. The documented example is fyp. This is a challenge-name lookup, not a general video keyword search. The optional max_cursor query input is available for pagination; omit it for an initial request. Cursor semantics and the response field to use for continuation have not been verified. The endpoint is documented as returning a challenge media feed, but no successful response sample or field schema is available for this operation. Individual video fields, response wrapper keys and pagination output therefore remain unverified. Treat returned content as a feed sample rather than a complete export of every video using the hashtag.

API Features

Hashtag-name entry point Start with the required challenge_name string, such as fyp, rather than a numeric challenge identifier.

Challenge-specific media discovery Request the feed associated with one named hashtag instead of running a broad keyword search across videos.

Optional maximum-cursor input The request accepts max_cursor for pagination. Leave it out initially; its continuation format and response mapping are not verified.

Feed-sample interpretation Use results as observed hashtag content. Neither exhaustive coverage nor a stable set of video response fields has been established.

Live API Demo

GET /api/project/tiktok/challenge-feed-by-keyword

API Response (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/tiktok/challenge-feed-by-keyword?key=<API_KEY>&challenge_name=fyp'

curl -X GET 'https://api.opendata-api.com/api/project/tiktok/challenge-feed-by-keyword?key=<API_KEY>&challenge_name=fyp'

📢

Need Help?

If you encounter API issues or need other API requirements, please contact us.

Use Cases

Let an editor review a feed for a known hashtag without first maintaining a separate challenge-ID registry.
Collect dated samples for a fixed list of campaign hashtag names, clearly labeling them as feed observations rather than all campaign posts.
Build a topic-review queue that keeps each requested hashtag name attached to its returned content for later editorial comparison.
Prototype a hashtag exploration interface with a name-based entry form and a visible warning that complete hashtag coverage is not guaranteed.

Frequently asked questions

Does challenge_name perform a general keyword search?

No. It identifies the challenge or hashtag whose media feed is requested. The documented example is fyp; this operation is not documented as a broad video text-search endpoint.

Do I need a numeric challenge ID?

No. This route requires the challenge_name string in the path, not a numeric challenge ID.

What should I send for max_cursor?

Omit this optional string on the first request. It is a pagination input, but its exact value format and the response field used for continuation have not been verified. Do not assume it is a page number.

Which video fields are verified for this feed?

No successful response sample or response field schema is available for this operation. The documented result is a challenge media feed, but video fields, wrapper keys and pagination output remain unverified.

Will this return every video using the hashtag?

Complete coverage is not established. Use the returned content as a feed sample and do not describe it as an exhaustive hashtag export.

Related operations

Guides

View Subscription Plans →

Get a TikTok hashtag feed by name