> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hooked.so/llms.txt
> Use this file to discover all available pages before exploring further.

# List Searches

> Get all saved searches for your team

## Overview

This endpoint returns all saved searches that have been created by your team. Searches contain aggregated analytics from scraped videos.

### Query Parameters

<ParamField query="platform" type="string">
  Filter by platform:

  * `tiktok`: TikTok searches only
  * `youtube`: YouTube searches only
  * Omit to get searches from all platforms
</ParamField>

<ParamField query="limit" type="number" default="50">
  Number of searches to return (1-100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Pagination offset
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="data">
    <ResponseField name="searches" type="array">
      Array of search objects

      <Expandable title="search">
        <ResponseField name="id" type="string">
          Internal search ID
        </ResponseField>

        <ResponseField name="searchTerm" type="string">
          The search term/query
        </ResponseField>

        <ResponseField name="platform" type="string">
          Platform (tiktok or youtube)
        </ResponseField>

        <ResponseField name="totalResults" type="number">
          Number of videos found
        </ResponseField>

        <ResponseField name="analytics" type="object">
          Aggregated analytics (avgViews, avgLikes, etc.)
        </ResponseField>

        <ResponseField name="topHashtags" type="array">
          Common hashtags in results
        </ResponseField>

        <ResponseField name="keywords" type="array">
          Extracted keywords
        </ResponseField>

        <ResponseField name="lastSearched" type="string">
          Last search timestamp
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="total" type="number">
      Total searches saved
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.hooked.so/v1/social/search/list?platform=tiktok" \
    -H "x-api-key: your_api_key_here"
  ```

  ```javascript Node.js theme={null}
  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);
  ```

  ```python Python theme={null}
  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']
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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
    }
  }
  ```
</ResponseExample>

<Tip>
  Use searches to track trending topics and discover content patterns in specific niches.
</Tip>


## OpenAPI

````yaml GET /v1/social/search/list
openapi: 3.0.0
info:
  title: Hooked API
  version: 1.0.0
  description: AI Video Generation API
servers:
  - url: https://api.hooked.so
security:
  - ApiKeyAuth: []
paths:
  /v1/social/search/list:
    get:
      tags:
        - Social Search
      summary: List Searches
      description: Get all saved searches for your team
      operationId: listSocialSearches
      parameters:
        - name: platform
          in: query
          schema:
            type: string
            enum:
              - tiktok
              - youtube
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Success
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````