Documentation — VelocityAPI

Base URL

https://api.velocityapi.top

Authentication

Send your API key with every request. Two equivalent options:

Via the RapidAPI marketplace — RapidAPI injects X-RapidAPI-Key automatically.
Directly — send your key as X-API-Key.

auth

curl https://api.velocityapi.top/v1/metadata \
  -G --data-urlencode "url=https://youtu.be/dQw4w9WgXcQ" \
  -H "X-API-Key: <your-key>"

Requests without a valid key return 401. The public /health endpoint needs no key.

Endpoints

GET /v1/metadata

Normalized metadata and stats for a video.

Param	Type	Notes
`url`	string (required)	YouTube or TikTok video URL

GET /v1/transcript

Transcript with timestamped segments.

Param	Type	Notes
`url`	string (required)	Video URL
`lang`	string (optional)	Preferred language code, e.g. `en`, `tr`

GET /v1/intelligence

Metadata + view-velocity + transcript in one response.

Param	Type	Notes
`url`	string (required)	Video URL
`transcript`	bool (optional)	Include transcript (default `true`)
`lang`	string (optional)	Preferred transcript language

Example response

200 OK

{
  "success": true,
  "data": {
    "metadata": {
      "video_id": "dQw4w9WgXcQ",
      "platform": "youtube",
      "title": "…",
      "view_count": 1000000
    },
    "velocity": { "views_per_day": 5814 },
    "transcript": { "available": true, "language": "en", "text": "…" }
  },
  "error": null
}

Errors & rate limits

401 — missing or invalid API key.
429 — rate limit or monthly quota exceeded. Upgrade your plan to raise the limit.
200 with success: false — the video couldn't be extracted (e.g. private/removed). Check error.

Rate limits are applied per API key. See pricing for per-plan limits.

Ready to build?

Grab a key and make your first call in minutes.

Get API access →

Quickstart & docs