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
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-changes 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'
Query Result
Use Cases
- Send leaving-soon alerts when a title on a user's watchlist appears with change_type=expiring for their country.
- Build a daily 'new on Netflix' digest by polling change_type=new with catalogs=netflix and show_type=movie for one country.
- Feed a licensing-churn dashboard that counts additions and removals per service from change_type=new and change_type=removed pages.
- Plan a content calendar of upcoming releases, setting include_unknown_dates=true so titles without a confirmed date still appear.
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.