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

**q** `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"`.

**platform** `string`

Filter results to a specific platform. Accepted values: `youtube`, `tiktok`, `instagram`, `x`, `facebook`. Omit to search across all supported platforms.

**limit** `number`

Number of results to return. Min `1`, max `20`. Defaults to `6`.

## 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"
  }
]
```

**platform** `string`

The platform the video was found on — e.g. `tiktok`, `youtube`, `instagram`.

**url** `string`

The canonical video URL. Pass this directly into `/v1/metadata`, `/v1/transcript`, or `/v1/extract`.

**title** `string`

The video's title or caption as it appears on the platform.

**author** `string`

The creator's handle or display name.

**stats** `object`

Engagement counts: `views`, `likes`, `comments`, and `shares`. Some fields may be `null` depending on platform availability.

**duration** `number`

Video length in seconds.

**thumbnail** `string`

URL of the video's thumbnail image.

**createdAt** `string`

ISO 8601 publish timestamp.

> [!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.

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.