TikTok post
/v1/tiktok/postGet one TikTok video by id — caption, author, counters, music and the media addresses, exactly as TikTok publishes it.
The payload arrives under aweme_detail, which is TikTok's own envelope and not
something we add. We return the address of any media and never fetch the file.
A video that does not exist, or has been deleted, answers 502 extraction_empty and is
not charged — TikTok reports both as a success with the aweme_detail key simply
absent.
curl "https://api.socialpipe.dev/v1/tiktok/post?aweme_id=$AWEME_ID" \ -H "Authorization: Bearer $SOCIALPIPE_KEY"Query Parameters
The long number at the end of a TikTok video URL, as a string. TikTok calls it an aweme_id. It is wider than a 32-bit integer, so a language that parses JSON numbers as floats will round it.
Max acceptable age of a cached result, in seconds. A lower value demands fresher data; it does not shorten what is stored.
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/tiktok/post?aweme_id=string"{ "cache_age": 0, "cached": false, "credits_remaining": 0, "credits_used": 0, "data": {}, "schema_version": "2", "success": true, "took_ms": 0}