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
Authentication
This endpoint requires anx-api-key header.
Parameters
The search query. Can be a topic, keyword, hashtag, creator name, or product name — e.g.
"skincare morning routine", "#fyp AI tools", or "@mkbhd".Filter results to a specific platform. Accepted values:
youtube, tiktok, instagram, x, facebook. Omit to search across all supported platforms.Example
Response
The canonical video URL. Pass this directly into
/v1/metadata, /v1/transcript, or /v1/extract.Engagement counts:
views, likes, comments, and shares. Some fields may be null depending on platform availability.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
Everyurl in the response can be passed directly into any other Veedcrawl endpoint: