Skip to main content
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

​
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

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"
  }
]
​
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.
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.