Skip to main content

TVMaze Schedule

TVmaze is a community-driven TV database that exposes a free, public REST API for TV schedules, shows, episodes, seasons, cast, and people. The Nexla connector ingests data from the TVmaze Schedule API, letting you pull daily air schedules, full show and episode catalogs, and search results into your Nexla flows.

TVMaze Schedule icon

Power end-to-end data operations for your TVMaze Schedule API with Nexla. Our bi-directional TVMaze Schedule connector is purpose-built for TVMaze Schedule, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to TVMaze Schedule or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your TVMaze Schedule workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites​

The TVmaze public API does not require authentication or an API key. All endpoints used by this connector are open and return JSON over HTTPS from the base URL https://api.tvmaze.com.

Keep the following in mind when configuring this connector:

  • The public API permits at least 20 calls every 10 seconds per IP address. Requests that exceed this may receive HTTP 429 responses, so schedule ingestion at a cadence that stays within the limit.

  • Because no credential fields are required, creating a credential in Nexla is a naming step only; it groups your TVmaze data flows and requires no secrets.

For complete details on the available endpoints, response structures, and usage limits, see the TVmaze API documentation.

Authenticate​

The TVmaze Schedule API requires no user-supplied credentials. You still create a named credential in Nexla so it can be selected when building a data flow.

Create a credential in Nexla​

  1. After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  3. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source creation.

Use as a data source​

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the TVMaze Schedule connector tile, then select the credential that will be used to connect to the TVmaze API, and click Next; or, create a new TVMaze Schedule credential for use in this flow.

Endpoint templates​

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common TVmaze endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

[Rest API] List Domestic

Retrieve the domestic (US, by default) TV schedule for a given date.

  • This endpoint returns the list of episodes airing on domestic (broadcast) channels. Each record includes episode and show details for the scheduled airing.

[Rest API] List Web

Retrieve the web/streaming schedule for a given country and date.

  • This endpoint returns episodes airing on web and streaming platforms. Use it when you need coverage of streaming releases rather than broadcast airings.

[Rest API] List Full Schedule

Retrieve the full schedule of upcoming episode airings across all countries.

  • This endpoint returns a large dataset covering all known future airings. Expect a high record volume and plan ingestion cadence accordingly.

[Rest API] Search Shows

Search for shows by name; returns a list of matches with relevance scores.

  • This endpoint requires a Query parameter containing the show name to search for. Each result includes the matched show and a relevance score.

[Rest API] Lookup Show

Look up the single best-matching show by name.

  • This endpoint requires a Query parameter containing the show name. It returns the single closest match rather than a list.

[Rest API] Get Show

Retrieve full information for a single show by ID.

  • This endpoint requires a Show ID parameter and returns the complete record for that show.

[Rest API] Get Show Episodes

Retrieve the full episode list for a show.

  • This endpoint requires a Show ID parameter and returns every episode for the specified show.

[Rest API] Get Show Seasons

Retrieve the list of seasons for a show.

  • This endpoint requires a Show ID parameter and returns the season records for the specified show.

[Rest API] Get Season Episodes

Retrieve the episode list for a single season.

  • This endpoint requires a Season ID parameter and returns every episode within that season.

[Rest API] Get Show Cast

Retrieve the cast list for a show.

  • This endpoint requires a Show ID parameter and returns the cast members and the characters they play.

[Rest API] Get Episode

Retrieve full information for a single episode by ID.

  • This endpoint requires an Episode ID parameter and returns the complete record for that episode.

[Rest API] Search People

Search for people (actors, crew) by name.

  • This endpoint requires a Query parameter containing the person's name and returns a list of matching people.

[Rest API] Get Person

Retrieve full information for a single person by ID.

  • This endpoint requires a Person ID parameter and returns the complete record for that person.

[Rest API] List Shows Index

Retrieve a paginated index of all shows in the TVmaze database (250 per page).

  • This endpoint accepts an optional Page parameter (default 0) and returns up to 250 shows per page. Increment the page value to walk the full catalog.

[Rest API] List People Index

Retrieve a paginated index of all people in the TVmaze database (1000 per page).

  • This endpoint accepts an optional Page parameter (default 0) and returns up to 1000 people per page. Increment the page value to walk the full catalog.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration​

TVMaze Schedule data sources can also be manually configured to ingest data from any valid TVmaze API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new TVMaze Schedule data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.