List new, removed, updated, expiring and upcoming titles for a country

View all Streaming Availability endpoints →

Returns the catalog changes for one country, 25 per page, ordered by the date of the change. Pass change_type to pick one of the documented change kinds (new, removed, updated, expiring, upcoming), item_type to pick the kind of item (show, and per the source description also season or episode), and country as an ISO 3166-1 alpha-2 code. Narrow further with catalogs (up to 32 service selectors), show_type (movie or series, only meaningful when item_type is show), order_direction (asc or desc), and inclusive from/to Unix timestamps. For past change types the window must fall between today and 31 days ago; for future change types between today and 31 days ahead. include_unknown_dates only affects future change types, since past changes always carry a timestamp. output_language localizes the joined show records (en, es, tr, fr). Paginate with cursor set to the previous response's nextCursor, URL-escaped because the value can contain ? and &. The first request needs no cursor. The response has four top-level fields, all observed live: changes (the page of change records), shows (the affected titles keyed by show id), hasMore and nextCursor. Each change record carries changeType, itemType, showId, showType, streamingOptionType, timestamp (Unix seconds), link (a deep link to the title on the service) and service (id, name, homePage, themeColorCode, imageSet). Each joined show carries id, itemType, showType, title, originalTitle, overview, releaseYear, runtime (minutes), rating, imdbId, tmdbId, genres (id and name), cast, directors, imageSet (verticalPoster, horizontalPoster, horizontalBackdrop at several widths) and streamingOptions keyed by country code, with per-option type, link, videoLink, audios, subtitles, availableSince, expiresSoon and the offering service. Field names come from a live probe (change_type=new, item_type=show, country=us, catalogs=netflix, show_type=movie) that returned 25 changes with hasMore true; the source description documents the other change types and item types, which were not exercised in that probe.

API Features

Five documented change types change_type selects new, removed, updated, expiring or upcoming, so one endpoint covers both the past licensing churn and the forward leaving-soon and coming-soon windows.
31-day from/to timestamp window from and to are inclusive Unix timestamps. Past change types accept today back to 31 days ago; future change types accept today out to 31 days ahead, and each side has a documented default when omitted.
Service selectors with offer type and addon catalogs takes up to 32 comma-separated selectors: a bare service id, service.subscription/free/rent/buy/addon, or service.addon.<addon id>. Omitting it searches every catalog in the country.
Unknown-date handling for future changes include_unknown_dates includes expiring and upcoming rows whose exact date a service never published. Those rows sort as timestamp 0, so they lead in ascending order and trail in descending order.
Cursor pagination at 25 per page Every page returns 25 changes plus hasMore and nextCursor. Pass the URL-escaped nextCursor back as cursor with otherwise identical parameters to walk the full result set.

Live API Demo

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

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-changes?key=<API_KEY>&change_type=new&country=<country>&include_unknown_dates=False&item_type=show&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 change_type values are documented?

The source documents five: new, removed and updated for past changes, plus expiring and upcoming for future changes. A live probe with change_type=new returned 25 change records whose changeType was new; the other four values are documented but were not exercised in that probe.

How far back or ahead can from and to reach?

For past change types (new, removed, updated) both timestamps must fall between today and 31 days ago. For future change types (expiring, upcoming) they must fall between today and 31 days from now. When omitted, past queries default to 31 days ago through today, and future queries default to today through 31 days ahead.

What does include_unknown_dates change?

Nothing for past change types, which always carry a timestamp. For expiring and upcoming it includes changes whose exact date the service never stated. Those rows are ordered as if their timestamp were 0, so they appear first in ascending order and last in descending order.

How do I page through more than 25 changes?

Check hasMore. When it is true, repeat the same request with cursor set to the previous response's nextCursor. URL-escape the cursor first, because it can contain ? and &. The first request omits cursor.

What does the catalogs parameter accept?

A comma-separated list of up to 32 selectors. A bare service id such as netflix searches that service's whole catalog; prime.subscription or peacock.free restricts to one streaming option type (subscription, free, rent, buy, addon); hulu.addon.hbo restricts to one addon. A title in any listed catalog is included. Omit the parameter to search every catalog in the country. Valid service and addon ids come from the countries directory.

Related operations

Guides

View Subscription Plans →