# Veedcrawl

Veedcrawl is a video intelligence API for agents and developers. It searches public videos from YouTube, TikTok, Instagram, X, and Facebook, then turns selected videos into structured data that software can read: metadata, transcripts, timestamps, creator details, and prompt-defined extraction results.

## Core API

- Base URL: https://api.veedcrawl.com
- Authentication: send an API key in the `x-api-key` header.
- Docs: https://docs.veedcrawl.com
- Playground: https://veedcrawl.com/playground
- API catalog: https://veedcrawl.com/.well-known/api-catalog
- OpenAPI: https://veedcrawl.com/openapi.json

## Main endpoints

- `GET /v1/metadata`: returns title, creator, platform, duration, thumbnail, counts, tags, and publish time.
- `POST /v1/search`: starts a social video search job across TikTok, Instagram, YouTube, and optional Facebook.
- `GET /v1/search/{jobId}`: polls search status and returns completed search results.
- `GET /v1/search/{jobId}/results`: returns completed search results only.
- `POST /v1/transcript`: starts a transcript job for a public video URL.
- `GET /v1/transcript/{jobId}`: polls transcript status and returns completed transcript output.
- `POST /v1/extract`: asks a custom question about a video and returns structured output.
- `GET /v1/extract/{jobId}`: polls extraction status.
- `GET /v1/tiktok/profile`: returns a public TikTok creator profile and recent videos.
- `GET /v1/instagram/profile`: returns a public Instagram profile and recent posts.

## Agent use cases

- Give browsing agents reliable video context instead of thumbnails and guessed captions.
- Search social platforms before choosing which videos to analyze.
- Build research workflows that compare creators, ads, hooks, and claims.
- Feed transcripts into search, knowledge bases, moderation tools, and content pipelines.
- Chain metadata, transcripts, and extraction into repeatable social video analysis.

## Discovery

- Markdown twin: https://veedcrawl.com/index.md
- API catalog: https://veedcrawl.com/.well-known/api-catalog
- Agent skills index: https://veedcrawl.com/.well-known/agent-skills/index.json
- MCP server card: https://veedcrawl.com/.well-known/mcp/server-card.json
- Status endpoint: https://api.veedcrawl.com/health