Skip to main content
GET
/
v1
/
social
/
search
/
list
curl -X GET "https://api.hooked.ai/v1/social/search/list?platform=tiktok" \
  -H "x-api-key: your_api_key_here"

{
  "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

​
platform
string
Filter by platform:
  • tiktok: TikTok searches only
  • youtube: YouTube searches only
  • Omit to get searches from all platforms
​
limit
number
default:"50"
Number of searches to return (1-100)
​
offset
number
default:"0"
Pagination offset

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
curl -X GET "https://api.hooked.ai/v1/social/search/list?platform=tiktok" \
  -H "x-api-key: your_api_key_here"

{
  "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.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
platform
enum<string>
Available options:
tiktok,
youtube
​
limit
integer
default:50
​
offset
integer
default:0

Response

200

Success