SocialPipe docs

Douyin Creator Fetch Creator Hot Spot Billboard

GET/v1/douyin/creator/fetch_creator_hot_spot_billboard

Returns personal data about people in bulk. The response carries accounts who are not the subject of your request. See our terms for what you may do with it.

Costs 1 credit. A cache hit costs nothing, and an answer that contains no data is never charged.

curl "https://api.socialpipe.dev/v1/douyin/creator/fetch_creator_hot_spot_billboard" \  -H "Authorization: Bearer $SOCIALPIPE_KEY"
AuthorizationBearer <token>

Your SocialPipe API key, as Authorization: Bearer sp_live_…. Create one in the dashboard.

In: header

Query Parameters

billboard_tag?|

'1004,1000,1002'/Hot spot tag - multiple tags separated by comma, like '1004,1000,1002'

hot_search_type?|

: 1=, 2=, 3=/Hot search type: 1=Overall ranking, 2=Local ranking, 3=Rising ranking

city_code?|

hot_search_type=2/City code - required when hot_search_type=2

cache_ttl?|

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

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/douyin/creator/fetch_creator_hot_spot_billboard"
{  "cache_age": 0,  "cached": false,  "credits_remaining": 0,  "credits_used": 0,  "data": {},  "schema_version": "2",  "success": true,  "took_ms": 0}