Skip to main content
GET
/
v1
/
social
/
search
/
{searchId}
curl -X GET "https://api.hooked.ai/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

searchId
string
required
The internal search ID

Query Parameters

limit
number
default:"50"
Number of videos to return (1-100)
offset
number
default:"0"
Pagination offset for videos

Response

success
boolean
Indicates if the request was successful
data
object
curl -X GET "https://api.hooked.ai/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.

Authorizations

x-api-key
string
header
required

Path Parameters

searchId
string
required

Query Parameters

limit
integer
default:50
offset
integer
default:0

Response

200

Success