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 — Free $5 Credit $0.01 / call

Try it live

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

POST/v1/youtube/resolveresolve$0.01/call

Response

Example response — hit "Send Request" 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);

What developers say

“Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.”
Marcus T.
SEO Platform Founder

“One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.”
Priya S.
Full-Stack Developer

“The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.”
Jake R.
Indie Hacker

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. $5 free credit on signup — no credit card required.

Get API Key — Free $5 Credit 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