curl -X GET "https://api.hooked.so/v1/social/search/list?platform=tiktok" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/search/list?platform=tiktok', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.searches);
import requests
response = requests.get(
'https://api.hooked.so/v1/social/search/list',
params={'platform': 'tiktok'},
headers={'x-api-key': 'your_api_key_here'}
)
searches = response.json()['data']['searches']
{
"success": true,
"data": {
"searches": [
{
"id": "clx123abc",
"searchTerm": "fitness motivation",
"platform": "tiktok",
"totalResults": 25,
"analytics": {
"avgViews": 1250000,
"avgLikes": 89000,
"avgComments": 1200,
"avgShares": 5600,
"engagementRate": 7.8
},
"topHashtags": ["fitness", "motivation", "workout", "gym"],
"keywords": ["fitness", "workout", "motivation"],
"keywordsStatus": "completed",
"lastSearched": "2024-01-15T10:30:00Z",
"createdAt": "2024-01-15T10:30:00Z"
}
],
"total": 8,
"limit": 50,
"offset": 0
}
}
Social Search
List Searches
Get all saved searches for your team
GET
/
v1
/
social
/
search
/
list
curl -X GET "https://api.hooked.so/v1/social/search/list?platform=tiktok" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/search/list?platform=tiktok', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.searches);
import requests
response = requests.get(
'https://api.hooked.so/v1/social/search/list',
params={'platform': 'tiktok'},
headers={'x-api-key': 'your_api_key_here'}
)
searches = response.json()['data']['searches']
{
"success": true,
"data": {
"searches": [
{
"id": "clx123abc",
"searchTerm": "fitness motivation",
"platform": "tiktok",
"totalResults": 25,
"analytics": {
"avgViews": 1250000,
"avgLikes": 89000,
"avgComments": 1200,
"avgShares": 5600,
"engagementRate": 7.8
},
"topHashtags": ["fitness", "motivation", "workout", "gym"],
"keywords": ["fitness", "workout", "motivation"],
"keywordsStatus": "completed",
"lastSearched": "2024-01-15T10:30:00Z",
"createdAt": "2024-01-15T10:30:00Z"
}
],
"total": 8,
"limit": 50,
"offset": 0
}
}
Overview
This endpoint returns all saved searches that have been created by your team. Searches contain aggregated analytics from scraped videos.Query Parameters
string
Filter by platform:
tiktok: TikTok searches onlyyoutube: YouTube searches only- Omit to get searches from all platforms
number
default:"50"
Number of searches to return (1-100)
number
default:"0"
Pagination offset
Response
boolean
Indicates if the request was successful
object
Show data
Show data
array
number
Total searches saved
curl -X GET "https://api.hooked.so/v1/social/search/list?platform=tiktok" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/search/list?platform=tiktok', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.searches);
import requests
response = requests.get(
'https://api.hooked.so/v1/social/search/list',
params={'platform': 'tiktok'},
headers={'x-api-key': 'your_api_key_here'}
)
searches = response.json()['data']['searches']
{
"success": true,
"data": {
"searches": [
{
"id": "clx123abc",
"searchTerm": "fitness motivation",
"platform": "tiktok",
"totalResults": 25,
"analytics": {
"avgViews": 1250000,
"avgLikes": 89000,
"avgComments": 1200,
"avgShares": 5600,
"engagementRate": 7.8
},
"topHashtags": ["fitness", "motivation", "workout", "gym"],
"keywords": ["fitness", "workout", "motivation"],
"keywordsStatus": "completed",
"lastSearched": "2024-01-15T10:30:00Z",
"createdAt": "2024-01-15T10:30:00Z"
}
],
"total": 8,
"limit": 50,
"offset": 0
}
}
Use searches to track trending topics and discover content patterns in specific niches.
⌘I