GET /v1/search — Search Social Videos

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

GET https://api.veedcrawl.com/v1/search

Authentication

This endpoint requires an x-api-key header.

Parameters

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

string

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

number

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

Example

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

Response

[
  {
    "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"
  }
]

string

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

string

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

string

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

string

The creator’s handle or display name.

object

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

number

Video length in seconds.

string

URL of the video’s thumbnail image.

string

ISO 8601 publish timestamp.

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:

# 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"}'

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.

Account

Video

Profiles

GET /v1/search — Search Social Videos

Endpoint

Authentication

Parameters

Example

Response

Chaining into other endpoints

​Endpoint

​Authentication

​Parameters

​Example

​Response

​Chaining into other endpoints

Endpoint

Authentication

Parameters

Example

Response

Chaining into other endpoints