TVMaze Schedule
Sync overview
This source retrieves historical and future TV scheduling data using the TVMaze schedule API.
Output schema
This source is capable of syncing the following streams:
domestic: episodes airing on TV networks indomestic_schedule_country_codefor each day in the date range (/schedule). The date range runs fromstart_datethroughend_dateinclusive (end_datedefaults to today).web: episodes airing on web/streaming channels for each day in the date range (/schedule/web), optionally filtered byweb_schedule_country_code.future: all future episodes known to TVMaze, regardless of country or date range (/schedule/full). This stream is full refresh only.
Features
| Feature | Supported? (Yes/No) | Notes |
|---|---|---|
| Full Refresh Sync | Yes | |
| Incremental Sync | Yes | domestic and web only |
Performance considerations
TVMaze has a rate limit of 20 requests per 10 seconds. This source should not run into this limit.
Getting started
Requirements
- Choose a start date for your sync. This may be in the future.
- Choose an ISO 3166-1 country code for domestic schedule syncs.
Setup guide
The following fields are required fields for the connector to work:
start_date: The start date to pullhistorydata from.- (optional)
end_date: The end date to pullhistorydata until. domestic_schedule_country_code: The ISO 3166-1 country code to pull domestic schedule data for.- (optional)
web_schedule_country_code: The ISO 3166-1 country code to pull web schedule data for. Can be left blank for all countries and global channels, or set to 'global' for only global channels.
IP allow list
If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Reference
Config fields reference
Field
Type
Property name
string
domestic_schedule_country_code
string
start_date
string
end_date
string
web_schedule_country_code
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.2.27 | 2026-10-13 | 79021 | Update dependencies |
| 0.2.26 | 2026-10-07 | 88260 | Fix country filter never being sent, point web stream at /schedule/web, include end_date (default: today) in the synced range, and make future a single full-refresh request instead of one full-schedule download per day |
| 0.2.25 | 2025-05-25 | 60539 | Update dependencies |
| 0.2.24 | 2025-05-10 | 60194 | Update dependencies |
| 0.2.23 | 2025-05-04 | 59574 | Update dependencies |
| 0.2.22 | 2025-04-27 | 58995 | Update dependencies |
| 0.2.21 | 2025-04-19 | 58440 | Update dependencies |
| 0.2.20 | 2025-04-12 | 58010 | Update dependencies |
| 0.2.19 | 2025-04-05 | 57444 | Update dependencies |
| 0.2.18 | 2025-03-29 | 56862 | Update dependencies |
| 0.2.17 | 2025-03-22 | 56315 | Update dependencies |
| 0.2.16 | 2025-03-08 | 55631 | Update dependencies |
| 0.2.15 | 2025-03-01 | 55100 | Update dependencies |
| 0.2.14 | 2025-02-22 | 54478 | Update dependencies |
| 0.2.13 | 2025-02-15 | 54103 | Update dependencies |
| 0.2.12 | 2025-02-08 | 53533 | Update dependencies |
| 0.2.11 | 2025-02-01 | 53088 | Update dependencies |
| 0.2.10 | 2025-01-25 | 52389 | Update dependencies |
| 0.2.9 | 2025-01-18 | 52015 | Update dependencies |
| 0.2.8 | 2025-01-11 | 51450 | Update dependencies |
| 0.2.7 | 2024-12-28 | 50766 | Update dependencies |
| 0.2.6 | 2024-12-21 | 50332 | Update dependencies |
| 0.2.5 | 2024-12-14 | 49740 | Update dependencies |
| 0.2.4 | 2024-12-12 | 49438 | Update dependencies |
| 0.2.3 | 2024-12-11 | 49108 | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
| 0.2.2 | 2024-10-28 | 47573 | Update dependencies |
| 0.2.1 | 2024-08-16 | 44196 | Bump source-declarative-manifest version |
| 0.2.0 | 2024-08-14 | 44055 | Refactor connector to manifest-only format |
| 0.1.13 | 2024-08-12 | 43740 | Update dependencies |
| 0.1.12 | 2024-08-10 | 43530 | Update dependencies |
| 0.1.11 | 2024-08-03 | 43094 | Update dependencies |
| 0.1.10 | 2024-07-27 | 42640 | Update dependencies |
| 0.1.9 | 2024-07-20 | 42386 | Update dependencies |
| 0.1.8 | 2024-07-13 | 41917 | Update dependencies |
| 0.1.7 | 2024-07-10 | 41358 | Update dependencies |
| 0.1.6 | 2024-07-09 | 40928 | Update dependencies |
| 0.1.5 | 2024-06-25 | 40349 | Update dependencies |
| 0.1.4 | 2024-06-22 | 40048 | Update dependencies |
| 0.1.3 | 2024-06-05 | 38837 | Make connector compatible with builder |
| 0.1.2 | 2024-06-04 | 39053 | [autopull] Upgrade base image to v1.2.1 |
| 0.1.1 | 2024-05-20 | 38453 | [autopull] base image + poetry + up_to_date |
| 0.1.0 | 2022-10-22 | 18333 | New source |