Get Services and Add-on Channels for One Country

View all Streaming Availability endpoints →

Pass a supported lowercase country-code path value, such as us, to retrieve one market's service directory. output_language selects en, es, tr or fr, with English as the default. The response is a single raw object with countryCode, name and services. The observed US response identified United States and included Netflix plus other regional services. Service entries contained id, name, homePage, themeColorCode, imageSet, a streamingOptionTypes object with boolean access-type flags, and an addons array. Add-on entries contained id, name, homePage, themeColorCode and imageSet. Use these service and add-on IDs to construct catalog selectors such as service.subscription or service.addon.addon_id. An empty addons array means no channels are listed for that service in this response. A supported access type is a directory capability, not evidence that a particular title is watchable. For a movie or series, resolve its identity and read its own streamingOptions.

API Features

Focused single-market response Retrieve the selected country's countryCode, name and services instead of downloading the complete country directory.
Boolean service capability flags Read each service's streamingOptionTypes object to distinguish supported viewing modes before offering access-type filters.
Regional add-on channel identifiers Discover the addons attached to a service in this country and use their IDs in fully qualified catalog selectors.
Service display assets and destinations Use service names, homePage, themeColorCode and imageSet metadata to assemble a regional platform settings screen.

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

Which parameter selects only the United States service directory?

Set the required country-code path input to us. Its name differs from the country query parameter on title and catalog searches. Discover valid codes through the supported-country directory; this endpoint returns one country's directory object.

How can I discover add-on IDs and construct a channel-specific catalog selector?

Find the parent service's id in services, then read channel IDs from its addons array. Construct service.addon.addon_id from those identifiers. Do not substitute display names or reuse an unverified channel identifier from another country.

Does an empty addons array mean the service has no movies?

No. It only means this response lists no add-on channels for that service. It does not describe title counts or individual viewing availability. Use catalog search for titles and each show's streamingOptions for its viewing destinations.

Is a directory homePage a movie playback link?

No. homePage is a service or channel homepage, while imageSet and themeColorCode support display. For a title-specific destination, look up the work and read link from its viewing options. Actual access still depends on the service's account, payment and regional requirements.

Related operations

Guides

View Subscription Plans →