curl -X GET "https://api.hooked.so/v1/social/search/clx123abc?limit=10" \
-H "x-api-key: your_api_key_here"
{
"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"
{
"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
The internal search ID
Query Parameters
Number of videos to return (1-100)
Pagination offset for videos
Response
Indicates if the request was successful
Show data
Show data
Search ID
The search query
Platform (tiktok or youtube)
Total videos found
Aggregated analytics for all videos
Common hashtags across results
Popular music/sounds used
Extracted keywords
Array of video objects with full details
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"
{
"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