TikTok — Get a post
Get a post by a canonical platform identifier. URLs must be converted before calling a data endpoint.
Get a post by a canonical platform identifier. URLs must be converted before calling a data endpoint.
The API key selects Test or Live. Do not send an environment header, parameter, or tool argument. null means unavailable, not zero.
Find compatible test data before you need another state.
The TypeScript and Go tabs use the official SDKs.
Request
Test
curl "https://api.openhandle.dev/v1/tiktok/posts/920100000000000001?freshness=24h" \
-H "Authorization: Bearer $OPENHANDLE_TEST_KEY"Expected: HTTP 200, Openhandle-Environment: test, Openhandle-Cost: 0.000, and dataset 2026-09-07.1. Fixture: tiktok.post.pixel-orchard-loop.
Live
curl "https://api.openhandle.dev/v1/tiktok/posts/$POST_ID?freshness=24h" \
-H "Authorization: Bearer $OPENHANDLE_LIVE_KEY"Live uses the same response schema and errors. It uses real public identifiers and normal billing.
Common parameters
freshness:live,24h(default),7d, or30d.
Answered Test results—including private and not-found answers—record a $0.000 actual charge and a separate live-equivalent price. Authentication, validation, rate-limit, service, and internal failures create request history only.