Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.veedcrawl.com/llms.txt

Use this file to discover all available pages before exploring further.

GET /v1/metadata returns structured metadata for any supported public video URL. This is a free endpoint — it consumes zero credits — so you can use it to inspect a video before deciding whether to run a transcript or extraction job on it.

​
Endpoint

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

​
Authentication

This endpoint requires an x-api-key header.

​
Parameters

​
url
string
required
The full public video URL. Supported platforms: YouTube, TikTok, Instagram, X/Twitter, and Facebook.

​
Example

curl "https://api.veedcrawl.com/v1/metadata?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ" \
  -H "x-api-key: YOUR_KEY"

​
Response

{
  "title": "Rick Astley - Never Gonna Give You Up",
  "author": "Rick Astley",
  "platform": "youtube",
  "duration": 213,
  "viewCount": 1400000000,
  "likeCount": 15000000,
  "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
}
​
title
string
The video’s title as it appears on the platform.
​
author
string
The display name of the channel or account that published the video.
​
platform
string
The platform the video was fetched from — e.g. youtube, tiktok, instagram.
​
duration
number
Video length in seconds.
​
viewCount
number
Total view count as reported by the platform.
​
likeCount
number
Total like count as reported by the platform.
​
thumbnail
string
URL of the video’s thumbnail image.
This is a free endpoint — 0 credits consumed. Use it to validate URLs or gather basic stats before committing credits to a transcript or extract job.