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

Lowercase slug genre ids Every entry pairs a short lowercase id such as scifi, thriller or documentary with a readable name, so you can store the id and show the name.
Plain root-array response The body is a bare JSON array of id and name objects without a wrapper, cursor or paging fields, so it can be cached and indexed by id in one pass.
Four output languages The optional output_language parameter accepts en, es, tr and fr and defaults to en, letting a multilingual interface request genre labels in its own language.
Vocabulary for the genres filter The ids returned here are the values the filtered catalog search expects in its genres parameter, which removes guesswork when building genre filters.
No required input The call works with no parameters at all, which makes it a simple startup or nightly refresh request for a small reference table.

Live API Demo

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

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-genres?key=<API_KEY>&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 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.

Related operations

Guides

View Subscription Plans →