TikTok Search Top
curl --request GET \
--url https://socialquery.dev/v1/tiktok/search/top \
--header 'x-api-key: <api-key>'import requests
url = "https://socialquery.dev/v1/tiktok/search/top"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://socialquery.dev/v1/tiktok/search/top', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"data": {}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}TikTok
TikTok Search Top
Tiktok search top. Availability depends on the configured provider route.
GET
/
tiktok
/
search
/
top
TikTok Search Top
curl --request GET \
--url https://socialquery.dev/v1/tiktok/search/top \
--header 'x-api-key: <api-key>'import requests
url = "https://socialquery.dev/v1/tiktok/search/top"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://socialquery.dev/v1/tiktok/search/top', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"data": {}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}{
"success": false,
"platform": "<string>",
"endpoint": "<string>",
"credits_used": 1,
"credits_remaining": 123,
"request_id": "<string>",
"cached": true,
"error": {
"code": "<string>",
"type": "<string>",
"message": "<string>",
"status": 123,
"doc_url": "<string>"
}
}Beta catalog endpoint. Provider activation and live verification are in progress. An unavailable operation returns HTTP 503 and uses no credits.
Authorizations
Query Parameters
Available options:
yesterday, this-week, this-month, last-3-months, last-6-months, all-time Available options:
relevance, most-liked, date-posted Required range:
x >= 0Required range:
1 <= x <= 3650Available options:
views Required range:
1 <= x <= 5Response
Successful response. data is specific to this operation.
Required range:
x >= 0Operation-specific data. Fields depend on the endpoint and upstream response; unavailable metrics may be null.
⌘I