> ## 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 — Fetch Video Metadata

> Retrieve title, author, view count, duration, and platform stats for any public YouTube, TikTok, Instagram, X, or Facebook video URL.

`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

<ParamField query="url" type="string" required>
  The full public video URL. Supported platforms: YouTube, TikTok, Instagram, X/Twitter, and Facebook.
</ParamField>

## Example

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

## Response

```json theme={null}
{
  "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"
}
```

<ResponseField name="title" type="string">
  The video's title as it appears on the platform.
</ResponseField>

<ResponseField name="author" type="string">
  The display name of the channel or account that published the video.
</ResponseField>

<ResponseField name="platform" type="string">
  The platform the video was fetched from — e.g. `youtube`, `tiktok`, `instagram`.
</ResponseField>

<ResponseField name="duration" type="number">
  Video length in seconds.
</ResponseField>

<ResponseField name="viewCount" type="number">
  Total view count as reported by the platform.
</ResponseField>

<ResponseField name="likeCount" type="number">
  Total like count as reported by the platform.
</ResponseField>

<ResponseField name="thumbnail" type="string">
  URL of the video's thumbnail image.
</ResponseField>

<Note>
  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.
</Note>