X trending
Current X/Twitter trends for a country, as TikHub returns it. The country is a name rather than an ISO code — `UnitedStates` is the vendor's default and its spelling. An unrecognised value still answers 200 with trends rather than an error, so a typo here degrades silently to some default rather than failing loudly. Cache with care: this is the one route whose answer is meant to change hourly.
/v1/twitter/trendingCurrent X/Twitter trends for a country, as TikHub returns it.
The country is a name rather than an ISO code — UnitedStates is the vendor's default
and its spelling. An unrecognised value still answers 200 with trends rather than an
error, so a typo here degrades silently to some default rather than failing loudly.
Cache with care: this is the one route whose answer is meant to change hourly.
Query Parameters
"UnitedStates"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/twitter/trending"{ "cache_age": 0, "cached": false, "credits_remaining": 0, "credits_used": 0, "data": {}, "schema_version": "2", "success": true, "took_ms": 0}X search GET
One page of X/Twitter search results, as TikHub returns it. **Results are not stable between calls.** Two identical requests measured minutes apart returned the same posts in a different order, so a cached response is one arbitrary ordering rather than a snapshot anyone can reproduce. Treat the result as a sample of what matches, not as a ranking. There is no `search_type`: the vendor documents one, accepts any string including nonsense, and could not be shown to act on it.
X user media GET
One page of a user's posts that carry media, as TikHub returns it. Same timeline shape as `/twitter/tweets`, filtered upstream to posts with images or video. Media URLs point at X's own CDN; nothing here fetches them.