YouTube Region Restriction Checker

🌍 Check YouTube region restrictions

Use YouTube Region Restriction Checker to check where public YouTube videos can be viewed by country. Add YouTube watch URLs, Shorts URLs, youtu.be links, embed URLs, or raw video IDs, and the Actor returns country availability, blocked countries, allowed countries, and video metadata in a clean dataset.

It is built for quick regional availability checks without a YouTube login, cookies, or API key. Use it when you need to audit licensing windows, verify campaign markets, check whether a video is globally available, or export YouTube video region availability for your own workflow.

✅ What this Actor does

• Checks public YouTube videos for region restriction data.
• Exports allowed countries, blocked countries, ISO country codes, and counts.
• Compares each video against your target countries, such as US, GB, DE, or Japan.
• Includes canonical video IDs, video URLs, titles, channels, duration, thumbnails, and playability status when available.
• Deduplicates repeated video targets by canonical YouTube video ID during the run.
• Runs through Apify infrastructure and can be used from the Apify API, schedules, integrations, or dataset exports.

🎯 Common use cases

• Check whether music videos, trailers, sports clips, educational videos, or branded content are blocked in important markets.
• Build a YouTube video availability report for media buying, localization, rights management, or creator operations.
• Monitor a list of videos before launching regional campaigns.
• Verify target-country availability before embedding or sharing YouTube links with an audience.
• Export structured YouTube region restriction data for spreadsheets, BI tools, or internal QA checks.

🚀 How to run

1. Paste one or more YouTube video targets into Video targets.
2. Add optional Target countries as ISO country codes or country names.
3. Start the Actor.
4. Open the dataset and export results as JSON, CSV, Excel, XML, or through the Apify API.

🧾 Input

The Actor accepts public YouTube video targets. You can mix formats in the same run:

https://www.youtube.com/watch?v=dQw4w9WgXcQ
https://youtu.be/9bZkp7q19f0
https://www.youtube.com/shorts/aqz-KE-bpKQ
dQw4w9WgXcQ

Target countries are optional. Use them when you want a quick market-by-market status in addition to the full allowed and blocked country lists.

{
  "videoTargets": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "https://youtu.be/9bZkp7q19f0"
  ],
  "targetCountries": ["US", "GB", "Germany", "Japan"]
}

📦 Output

Each checked video is saved as one dataset item. The output includes:

• videoId and videoUrl
• title, channelId, channelTitle, durationSeconds, and thumbnailUrl
• playabilityStatus and playabilityReason
• allowedCountries and blockedCountries
• allowedCountryCodes and blockedCountryCodes
• totalAllowedCountries and totalBlockedCountries
• isGloballyAvailable and regionRestrictionStatus
• targetCountries with each requested country's availability
• checkedAt

Example item:

{
  "status": "checked",
  "playabilityStatus": "OK",
  "videoId": "dQw4w9WgXcQ",
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "title": "Example video title",
  "channelTitle": "Example channel",
  "allowedCountries": ["Canada", "Germany", "United Kingdom", "United States"],
  "blockedCountries": ["France", "Japan"],
  "allowedCountryCodes": ["CA", "DE", "GB", "US"],
  "blockedCountryCodes": ["FR", "JP"],
  "totalAllowedCountries": 4,
  "totalBlockedCountries": 2,
  "isGloballyAvailable": false,
  "regionRestrictionStatus": "restricted",
  "targetCountries": [
    {
      "input": "US",
      "countryCode": "US",
      "countryName": "United States",
      "availability": "allowed"
    },
    {
      "input": "Japan",
      "countryCode": "JP",
      "countryName": "Japan",
      "availability": "blocked"
    }
  ],
  "checkedAt": "2026-06-14T12:00:00.000Z"
}

💳 Pricing

This Actor uses pay-per-result pricing. You are charged only for videos that are successfully checked and emitted to the dataset.

• Event: checked-video
• Price: $0.00265 per checked video
• Approximate cost: $2.65 per 1,000 checked videos

⚠️ Limits and notes

• The Actor checks public YouTube pages and does not use private accounts, cookies, or the official YouTube API.
• Private, removed, age-gated, unavailable, or bot-check-protected videos may not emit a dataset row if YouTube does not expose usable region availability data.
• YouTube may report a video as playable while still omitting explicit country lists. In that case, the Actor records the availability fields that YouTube exposes.
• Region availability can change over time when uploaders, rights holders, or YouTube update restrictions.

❓ FAQ

Can I check raw YouTube video IDs?

Yes. You can enter raw 11-character YouTube video IDs, full watch URLs, Shorts URLs, youtu.be links, or embed URLs.

Do I need a YouTube API key?

No. The Actor does not require a YouTube API key, login, cookies, or OAuth setup.

What happens if I provide duplicate videos?

The run deduplicates targets by canonical YouTube video ID, so the dataset contains one checked result per unique video.

Can I check only a few countries?

Yes. Add target countries to get a compact allowed, blocked, or unknown status for the markets you care about. The Actor still returns the full allowed and blocked country data when YouTube exposes it.

Does it download videos?

No. This Actor checks region availability and video metadata only. It does not download video files.

📝 Changelog

• 0.1: Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Other actors

• YouTube Trending Videos Scraper ↗ - Track trending YouTube videos by region and category.
• YouTube Channel Statistics Scraper ↗ - Export public YouTube channel statistics for reporting.
• YouTube Channel Search Scraper ↗ - Find public YouTube channels from search keywords.
• YouTube Channel Scraper ↗ - Collect public YouTube channel profiles and recent video data.
• TikTok Transcript Scraper ↗ - Extract public TikTok transcript text for video analysis.

Made with ❤️ by Maxime Dupré