TikTok Challenge Feed by ID for Hashtag Video Samples

Request the media feed associated with a TikTok challenge (hashtag). Supply the required challenge_id path parameter as a string; its documented default is 229207. The optional max_cursor query parameter is also a string and has no documented default or example. Omit it for an initial request rather than inventing a starting value. No live response was observed for this route, and no response example or field schema was supplied. Media item fields, the item-list container, any next-cursor field and end-of-feed indicators are therefore unverified. Before requesting subsequent pages, establish how the real response maps to max_cursor. Treat returned media as a bounded sample, not a guaranteed complete historical export, exhaustive list of challenge participants or fixed-order ranking.

API Features

Challenge-linked media requests Target media associated with one known challenge_id instead of requesting only information about the hashtag itself.

Optional max_cursor input Provide the supported string cursor for a follow-up request only after confirming its relationship to the actual response.

Cursor-free initial sampling Start with the required challenge identifier alone; no max_cursor default or example is documented for this feed.

Campaign media review batches Collect bounded feed responses for a chosen challenge and retain request context for later content review without promising complete coverage.

Live API Demo

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

API Response (JSON)

{}

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

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

📢

Need Help?

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

Use Cases

Collect a bounded set of media associated with a campaign challenge_id for manual creative review.
Save challenge_id, a locally recorded fetch timestamp and any returned video identifiers after verifying their field locations, to link feed samples across reviews.
Checkpoint the submitted max_cursor for a resumable hashtag-content review once the real response cursor mapping has been established.
Compare newly collected challenge-feed samples across review dates to select illustrative posts, without treating the samples as complete participation totals.

Frequently asked questions

Which inputs are required to request a challenge feed?

Only challenge_id is required. It is a string path parameter with the documented default 229207. max_cursor is an optional string query parameter.

What max_cursor value should I use for the first request?

No starting value is documented. Omit max_cursor initially, inspect the response, and confirm the response-to-input cursor mapping before attempting another page.

Which fields contain videos and the next cursor?

Their field names are not confirmed for this route because no observed response or response example was supplied. Validate the returned media container, item identifiers, cursor and termination indicators before implementing pagination.

Does the feed guarantee every video using the hashtag?

No complete historical coverage, fixed ordering or exhaustive participant list is documented. Treat responses as bounded media samples for the requested challenge.

Related operations

Guides

View Subscription Plans →

Request a TikTok Challenge Media Feed by ID