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

# GET /v1/search — Search Social Videos

> Search for public social videos by topic, creator, hashtag, or keyword across YouTube, TikTok, Instagram, X, and Facebook.

`GET /v1/search` finds public social videos matching a query — by topic, creator name, hashtag, product, or keyword. It removes the prerequisite of knowing a video URL before calling any other Veedcrawl endpoint. Your agent can discover relevant videos, then chain directly into `/v1/metadata`, `/v1/transcript`, or `/v1/extract` on the results.

## Endpoint

```text theme={null}
GET https://api.veedcrawl.com/v1/search
```

## Authentication

This endpoint requires an `x-api-key` header.

## Parameters

<ParamField query="q" type="string" required>
  The search query. Can be a topic, keyword, hashtag, creator name, or product name — e.g. `"skincare morning routine"`, `"#fyp AI tools"`, or `"@mkbhd"`.
</ParamField>

<ParamField query="platform" type="string">
  Filter results to a specific platform. Accepted values: `youtube`, `tiktok`, `instagram`, `x`, `facebook`. Omit to search across all supported platforms.
</ParamField>

<ParamField query="limit" type="number">
  Number of results to return. Min `1`, max `20`. Defaults to `6`.
</ParamField>

## Example

```bash theme={null}
curl "https://api.veedcrawl.com/v1/search?q=skincare+morning+routine&platform=tiktok&limit=6" \
  -H "x-api-key: YOUR_KEY"
```

## Response

```json theme={null}
[
  {
    "platform": "tiktok",
    "url": "https://www.tiktok.com/@creator/video/7380000000000001",
    "title": "my 5-step skincare morning routine",
    "author": "@glowwithme",
    "stats": {
      "views": 2100000,
      "likes": 87400,
      "comments": 3200,
      "shares": null
    },
    "duration": 62,
    "thumbnail": "https://...",
    "createdAt": "2026-05-01T09:14:00.000Z"
  },
  {
    "platform": "instagram",
    "url": "https://www.instagram.com/reel/ABC123XYZ/",
    "title": "three-step morning hook",
    "author": "@skincarebyara",
    "stats": {
      "views": 814000,
      "likes": 61200,
      "comments": 980,
      "shares": null
    },
    "duration": 28,
    "thumbnail": "https://...",
    "createdAt": "2026-04-28T14:00:00.000Z"
  }
]
```

<ResponseField name="platform" type="string">
  The platform the video was found on — e.g. `tiktok`, `youtube`, `instagram`.
</ResponseField>

<ResponseField name="url" type="string">
  The canonical video URL. Pass this directly into `/v1/metadata`, `/v1/transcript`, or `/v1/extract`.
</ResponseField>

<ResponseField name="title" type="string">
  The video's title or caption as it appears on the platform.
</ResponseField>

<ResponseField name="author" type="string">
  The creator's handle or display name.
</ResponseField>

<ResponseField name="stats" type="object">
  Engagement counts: `views`, `likes`, `comments`, and `shares`. Some fields may be `null` depending on platform availability.
</ResponseField>

<ResponseField name="duration" type="number">
  Video length in seconds.
</ResponseField>

<ResponseField name="thumbnail" type="string">
  URL of the video's thumbnail image.
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 publish timestamp.
</ResponseField>

<Note>
  This endpoint is free and does not consume credits. It is designed as the discovery layer before you commit credits to transcript or extract jobs.
</Note>

## Chaining into other endpoints

Every `url` in the response can be passed directly into any other Veedcrawl endpoint:

```bash theme={null}
# 1. Search for relevant videos
curl "https://api.veedcrawl.com/v1/search?q=AI+tools+developer&platform=youtube&limit=3" \
  -H "x-api-key: YOUR_KEY"

# 2. Transcribe the top result
curl -X POST "https://api.veedcrawl.com/v1/transcript" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "<url from search result>", "mode": "auto"}'

# 3. Extract structured insights
curl -X POST "https://api.veedcrawl.com/v1/extract" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "<url from search result>", "prompt": "List every tool mentioned and the use case for each"}'
```

<Tip>
  Combine the `platform` filter with a narrow query to get highly targeted results. For example, `q=skincare serum&platform=instagram` returns Reels from Instagram only.
</Tip>