List supported streaming genres
View all Streaming Availability endpoints →Returns the full list of genres used to classify movies and series, as a plain JSON array of objects with a string id and a display name. The only input is the optional output_language query parameter (en, es, tr or fr, default en), which selects the language of the output. In a sample call with default settings the endpoint answered HTTP 200 with a root array of 21 entries, each carrying exactly the fields id (for example scifi or thriller) and name (for example Science Fiction or Thriller); no wrapper object, cursor or pagination fields were present. The ids are the values accepted by the genres parameter of the filtered catalog search, so this list is the vocabulary behind genre filtering. The sample call used the default language only, so translated names for es, tr and fr are documented but were not verified in the sample.
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-genres API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/streaming-availability/get-genres?key=<API_KEY>&output_language=en'
Query Result
Use Cases
- Fill a genre dropdown or chip row from live ids instead of hardcoding genre names in the app
- Cache the genre dictionary once per day and translate the genre ids found on show records into labels
- Show genre labels in Spanish, Turkish or French in a multilingual interface by passing output_language
- Validate user-supplied genre slugs before sending a genre-filtered catalog search
- Build a mood picker that maps each mood to a combination of genre ids for recommendation filters
Frequently asked questions
What does the genres endpoint return?
A JSON array at the root of the response. Each element has a string id and a string name; in the sample call all 21 entries had only these two fields, for example id scifi with name Science Fiction.
Do I have to send any parameters?
No. The only parameter is output_language, which is optional, accepts en, es, tr or fr, and defaults to en.
How do I use these ids in a catalog search?
Pass one or more ids as a comma-separated list in the genres parameter of the filtered catalog search, for example scifi,thriller, and use genres_relation to require all of them (and) or at least one (or).
Are the genre names translated when I change output_language?
The parameter is documented to set the language of the output, but the sample call only used the default English, so translated names were not verified. Key your own data on the id rather than the name.
Is this response paginated?
No. The sample call returned the whole list in a single array with no cursor, hasMore or nextCursor fields, so one request is enough.
How often should I refresh the genre list?
The source does not state how often the list changes. Because it is a short reference table, fetching it on startup or once a day and caching it is a reasonable approach.