Get one country's streaming services, offer types and add-ons
View all Streaming Availability endpoints →Returns a single country object for the ISO 3166-1 alpha-2 code in the country-code path parameter: countryCode, name and services. A live probe for us returned the United States with 20 services. Each service has id, name, homePage, themeColorCode, imageSet (lightThemeImage, darkThemeImage and whiteImage logo URLs), streamingOptionTypes and addons. streamingOptionTypes is an object of booleans for addon, buy, rent, free and subscription, so you can tell whether a service sells rentals, purchases, a free tier or only subscriptions in that country. Each addon has id, name, homePage, themeColorCode and its own imageSet. In the US sample, six services carried addons, ranging from one to 140 (Prime Video). output_language (en, es, tr, fr) localizes the returned names. Use this when you already know the country and want its service ids, offer types and addon ids to validate a catalogs selector before querying a catalog or change feed. The field names and counts above were observed live for us; the source description confirms the payload lists the country's supported services with names, logos, supported streaming types and available addons.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/streaming-availability/get-country API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/streaming-availability/get-country?key=<API_KEY>&country-code=<country-code>&output_language=en'
Query Result
Use Cases
- Render a signup service picker that shows only the services actually sold in the user's country, with their logos.
- Read streamingOptionTypes to decide whether to offer rent, buy, free or subscription filters for a service in that country.
- List a service's add-on channels so the interface can label an option as included via a specific channel.
- Validate that a catalogs selector is a real service or addon id in that country before issuing a catalog or change query.
Frequently asked questions
What does the country-code path parameter expect?
An ISO 3166-1 alpha-2 code such as us. A live probe with country-code=us returned the United States object with 20 services. The supported codes are the keys of the full countries directory.
How does this differ from the full countries directory?
The directory returns every supported country in one object. This endpoint returns the same country object shape for exactly one code, which is cheaper to fetch and cache when the country is already known.
How many services and add-ons should I expect?
It varies by country. The live US sample had 20 services, and six of them had addons: counts ranged from one up to 140 on Prime Video. Other countries in the directory sample had as few as one service.
What are the streamingOptionTypes flags?
An object with a boolean for each of addon, buy, rent, free and subscription, describing which offer types that service sells in this country. They correspond to the streaming option type suffixes accepted by catalog selectors.
Can I use the returned ids directly in other queries?
Yes. A service's id is a valid catalogs selector, and an addon's id extends it as service.addon.<addon id>. Checking them here first avoids sending a selector the country does not support.