curl -X GET "https://api.hooked.so/v1/social/search/clx123abc?limit=10" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/search/clx123abc?limit=10', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.videos);
import requests
response = requests.get(
'https://api.hooked.so/v1/social/search/clx123abc',
params={'limit': 10},
headers={'x-api-key': 'your_api_key_here'}
)
search = response.json()['data']
for video in search['videos']:
print(f"{video['title']} - {video['stats']['views']} views")
{
"success": true,
"data": {
"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"],
"music": ["Workout Beats", "Gym Motivation Mix"],
"keywords": ["fitness", "workout", "motivation"],
"keywordsStatus": "completed",
"videos": [
{
"id": "video123",
"externalId": "7234567890123456789",
"platform": "tiktok",
"title": "Morning workout routine #fitness",
"description": "Start your day right with this quick workout",
"thumbnailUrl": "https://cdn.tiktok.com/thumb.jpg",
"videoUrl": "https://www.tiktok.com/@creator/video/7234567890123456789",
"duration": 45,
"creator": {
"username": "fitnessguru",
"displayName": "Fitness Guru",
"avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
"followers": 1500000,
"isVerified": true
},
"stats": {
"views": 2300000,
"likes": 156000,
"comments": 2100,
"shares": 8900
},
"viralScore": 88.5,
"engagementRate": 7.2,
"hashtags": ["fitness", "workout", "morning"],
"music": {
"title": "Workout Beats",
"artist": "FitMusic"
},
"publishedAt": "2024-01-15T06:30:00Z"
}
],
"pagination": {
"total": 25,
"limit": 10,
"offset": 0,
"hasMore": true
},
"lastSearched": "2024-01-15T10:30:00Z",
"createdAt": "2024-01-15T10:30:00Z"
}
}
Social Search
Search Details
Get detailed information about a search including its videos
GET
/
v1
/
social
/
search
/
{searchId}
curl -X GET "https://api.hooked.so/v1/social/search/clx123abc?limit=10" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/search/clx123abc?limit=10', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.videos);
import requests
response = requests.get(
'https://api.hooked.so/v1/social/search/clx123abc',
params={'limit': 10},
headers={'x-api-key': 'your_api_key_here'}
)
search = response.json()['data']
for video in search['videos']:
print(f"{video['title']} - {video['stats']['views']} views")
{
"success": true,
"data": {
"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"],
"music": ["Workout Beats", "Gym Motivation Mix"],
"keywords": ["fitness", "workout", "motivation"],
"keywordsStatus": "completed",
"videos": [
{
"id": "video123",
"externalId": "7234567890123456789",
"platform": "tiktok",
"title": "Morning workout routine #fitness",
"description": "Start your day right with this quick workout",
"thumbnailUrl": "https://cdn.tiktok.com/thumb.jpg",
"videoUrl": "https://www.tiktok.com/@creator/video/7234567890123456789",
"duration": 45,
"creator": {
"username": "fitnessguru",
"displayName": "Fitness Guru",
"avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
"followers": 1500000,
"isVerified": true
},
"stats": {
"views": 2300000,
"likes": 156000,
"comments": 2100,
"shares": 8900
},
"viralScore": 88.5,
"engagementRate": 7.2,
"hashtags": ["fitness", "workout", "morning"],
"music": {
"title": "Workout Beats",
"artist": "FitMusic"
},
"publishedAt": "2024-01-15T06:30:00Z"
}
],
"pagination": {
"total": 25,
"limit": 10,
"offset": 0,
"hasMore": true
},
"lastSearched": "2024-01-15T10:30:00Z",
"createdAt": "2024-01-15T10:30:00Z"
}
}
Overview
This endpoint returns detailed information about a specific search, including all the scraped videos with their individual analytics.Path Parameters
string
required
The internal search ID
Query Parameters
number
default:"50"
Number of videos to return (1-100)
number
default:"0"
Pagination offset for videos
Response
boolean
Indicates if the request was successful
object
Show data
Show data
string
Search ID
string
The search query
string
Platform (tiktok or youtube)
number
Total videos found
object
Aggregated analytics for all videos
array
Common hashtags across results
array
Popular music/sounds used
array
Extracted keywords
array
Array of video objects with full details
object
Pagination information (total, limit, offset, hasMore)
curl -X GET "https://api.hooked.so/v1/social/search/clx123abc?limit=10" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/social/search/clx123abc?limit=10', {
headers: {
'x-api-key': 'your_api_key_here'
}
});
const data = await response.json();
console.log(data.data.videos);
import requests
response = requests.get(
'https://api.hooked.so/v1/social/search/clx123abc',
params={'limit': 10},
headers={'x-api-key': 'your_api_key_here'}
)
search = response.json()['data']
for video in search['videos']:
print(f"{video['title']} - {video['stats']['views']} views")
{
"success": true,
"data": {
"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"],
"music": ["Workout Beats", "Gym Motivation Mix"],
"keywords": ["fitness", "workout", "motivation"],
"keywordsStatus": "completed",
"videos": [
{
"id": "video123",
"externalId": "7234567890123456789",
"platform": "tiktok",
"title": "Morning workout routine #fitness",
"description": "Start your day right with this quick workout",
"thumbnailUrl": "https://cdn.tiktok.com/thumb.jpg",
"videoUrl": "https://www.tiktok.com/@creator/video/7234567890123456789",
"duration": 45,
"creator": {
"username": "fitnessguru",
"displayName": "Fitness Guru",
"avatarUrl": "https://cdn.tiktok.com/avatar.jpg",
"followers": 1500000,
"isVerified": true
},
"stats": {
"views": 2300000,
"likes": 156000,
"comments": 2100,
"shares": 8900
},
"viralScore": 88.5,
"engagementRate": 7.2,
"hashtags": ["fitness", "workout", "morning"],
"music": {
"title": "Workout Beats",
"artist": "FitMusic"
},
"publishedAt": "2024-01-15T06:30:00Z"
}
],
"pagination": {
"total": 25,
"limit": 10,
"offset": 0,
"hasMore": true
},
"lastSearched": "2024-01-15T10:30:00Z",
"createdAt": "2024-01-15T10:30:00Z"
}
}
Videos are sorted by viral score in descending order, so the most viral content appears first.
⌘I