POST/v1/youtube/resolve

YouTube URL Resolver API

Resolve any YouTube URL to a canonical video, channel, or playlist ID. Handle shortened URLs and redirects programmatically from $0.01/call.

Convert any YouTube URL (short links, share links, channel URLs) into a structured response with the content type and ID. Useful for normalizing user-submitted URLs.

Full Docs Get API Key $0.01 / call

Try it live

Fill in the fields and hit Run to see a real response.

POST /v1/youtube/resolve$0.01/call

Live testing

API Key

YouTube URL*

Response

Example response — hit "Run" to see a live result

{
  "ok": true,
  "data": {
    "webPageType": "WEB_PAGE_TYPE_WATCH",
    "videoId": "dQw4w9WgXcQ"
  }
}

Features

✓Resolve any YouTube URL format

✓Returns content type (video, channel, playlist)

✓Returns the canonical ID

✓Handles short links, share links, and vanity URLs

Use cases

URL Normalization

Convert user-submitted YouTube URLs in any format into canonical video/channel/playlist IDs.

Input Validation

Verify and validate YouTube URLs submitted by users in your application.

Link Processing

Process scraped or imported YouTube links into a consistent format for your database.

API Orchestration

Use as a first step to get the ID before calling other YouTube API endpoints.

Quick start

Copy this snippet and start making calls.

const res = await fetch('https://api.yepapi.com/v1/youtube/resolve', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  }),
});
const data = await res.json();
console.log(data);

Why YepAPI is cheaper

No monthly minimums. No enterprise plans. Just pay per call.

Provider	Cost / call	Catch
YepAPI	$0.01	No minimum. Pay as you go.
YouTube Data API v3	$0.00	No direct equivalent

Frequently asked questions

Convert any YouTube URL (short links, share links, channel URLs) into a structured response with the content type and ID. Useful for normalizing user-submitted URLs.

Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.

Sign up for a free API key, then send a POST request to /v1/youtube/resolve. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.

YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.

Ready to integrate?

Get your API key and start making calls in 30 seconds. No credit card required.

Get Started Read Docs

More youtube api endpoints

Search

$0.01

YouTube search API — find videos, channels, and playlists with filters for date, duration, and type. Structured JSON results from $0.01/call.

POST /v1/youtube/search

Video Details

$0.02

Full YouTube video metadata — title, views, likes, description, keywords, thumbnails, and available formats. Video intelligence from $0.02/call.

POST /v1/youtube/video

Comments