SocialPipe docs

Tiktok App V3 Fetch Creator Search Insights Detail

GET/v1/tiktok/app/v3/fetch_creator_search_insights_detail

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/tiktok/app/v3/fetch_creator_search_insights_detail" \  -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

query_id_str*Query Id Str

ID fetch_creator_search_insights /Query ID from fetch_creator_search_insights

time_range?|

Time range (past_7_days/past_30_days/past_60_days/past_6_months/custom)

start_date?|

time_range=custom /Start timestamp (seconds), only for custom range

end_date?|

time_range=custom /End timestamp (seconds), only for custom range

dimension_list?|

Dimension list (gender/age/country)

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/tiktok/app/v3/fetch_creator_search_insights_detail?query_id_str=122991006"
{  "cache_age": 0,  "cached": false,  "credits_remaining": 0,  "credits_used": 0,  "data": {},  "schema_version": "2",  "success": true,  "took_ms": 0}