> ## 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.

# Search Details

> Get detailed information about a search including its videos

## Overview

This endpoint returns detailed information about a specific search, including all the scraped videos with their individual analytics.

### Path Parameters

<ParamField path="searchId" type="string" required>
  The internal search ID
</ParamField>

### Query Parameters

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

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

### Response

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

<ResponseField name="data" type="object">
  <Expandable title="data">
    <ResponseField name="id" type="string">
      Search ID
    </ResponseField>

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

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

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

    <ResponseField name="analytics" type="object">
      Aggregated analytics for all videos
    </ResponseField>

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

    <ResponseField name="music" type="array">
      Popular music/sounds used
    </ResponseField>

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

    <ResponseField name="videos" type="array">
      Array of video objects with full details
    </ResponseField>

    <ResponseField name="pagination" type="object">
      Pagination information (total, limit, offset, hasMore)
    </ResponseField>
  </Expandable>
</ResponseField>

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

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

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

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

<Tip>
  Videos are sorted by viral score in descending order, so the most viral content appears first.
</Tip>


## OpenAPI

````yaml GET /v1/social/search/{searchId}
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/{searchId}:
    get:
      tags:
        - Social Search
      summary: Search Details
      description: Get detailed information about a search including its videos
      operationId: getSocialSearch
      parameters:
        - name: searchId
          in: path
          required: true
          schema:
            type: string
        - 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

````