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

One country, fetched by code Pass an ISO 3166-1 alpha-2 code in the path and get that country's entry alone, instead of downloading the full 65-country directory.
Offer type booleans per service streamingOptionTypes flags addon, buy, rent, free and subscription individually, so a UI can hide rent or buy controls for services that do not sell them in that country.
Add-on channels with their own logos Each service's addons array lists channel id, name, home page, theme color and logo set, so 'included via channel' options can be labeled with the right brand.
Homepage and deep-link targets Every service and addon carries a homePage URL alongside its id, giving a comparison table both a link and the selector value other queries expect.
Selector validation before a catalog query The returned service and addon ids are exactly the catalogs selectors other endpoints accept, so an unknown service id can be rejected before it is sent.

Live API Demo

GET /api/project/streaming-availability/get-country

Request cost is temporarily unavailable. No price is assumed.

View pricing

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'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →