Chocodata
public Via Universal scraper News & Media

TVmaze Scraper API

Access any TVmaze page using our TVmaze Scraper API. Point one API request at a TVmaze URL and get structured JSON back while we get past CAPTCHAs, IP rate limiting, IP blocking, and headless-browser detection through residential proxies. Get back fields like show title, air status, network or web channel, genres as structured JSON.

check_circle 1,000 free requests/month. No credit card. Residential proxies.

Request
curl "https://api.chocodata.com/api/v1/universal/get?api_key=YOUR_API_KEY&url=https://www.tvmaze.com/"
JSON Response
200 OK
{
  "success": true,
  "url": "https://www.tvmaze.com/",
  "status": 200,
  "content": "parsed TVmaze page content..."
  // + more fields
}
lan 235 targets
vpn_lock Residential proxy network
data_object Structured JSON
redeem 1,000 free requests/mo

TVmaze is served through the Universal Web Scraper API

You scrape TVmaze with Chocodata's Universal Web Scraper API: point it at any TVmaze URL and get the page back as structured JSON. Residential proxies, rotation, and retries are handled for you, with no TVmaze-specific setup. The same API key and credits work here as on every dedicated endpoint.

About TVmaze

TVmaze is a community-maintained database of TV shows covering episode guides, cast, air dates, and network details. Show and search pages expose titles, status, schedule, genres, and episode lists that are valuable to extract.

Scraping note: TVmaze also offers a free, well-documented public REST API that returns the same show and episode data as clean JSON, which is preferable for bulk access.

Example TVmaze page

https://www.tvmaze.com/shows/82/game-of-thrones

Pass a URL like this as url= to the Universal Web Scraper API and get it back as JSON.

Fields you can extract from TVmaze

check_small show title check_small air status check_small network or web channel check_small genres check_small premiere date check_small episode and season list

Common use: A TV-tracking app scrapes TVmaze show pages to build episode calendars and air-date reminders for the series users follow.

Everything you need to scrape TVmaze

Residential proxies keep your own IP out of every request, the JSON comes back clean, and 1,000 free requests a month let you prove tvmaze scraper works before you add a card.

data_object

Clean structured JSON

The TVmaze page comes back as JSON in the parse mode you choose: auto, html, text, or json. No selectors to maintain for tvmaze scraper.

gpp_good

Bypasses CAPTCHAs and anti-bot defenses

We get past CAPTCHAs, IP rate limiting, IP blocking, and headless-browser detection on TVmaze using rotating, country-matched residential proxies, so requests look like real users and your own IP stays private.

api

One API call

Scraping TVmaze is one simple API call. The same key works across our whole web scraping API: all 235 targets, any language, no SDK required.

travel_explore

Geo-targeting and JS rendering

Pass a country for proxy geo-targeting and turn on JavaScript rendering when a TVmaze page needs it. tvmaze data api handles dynamic content and region-locked results.

Scrape TVmaze in one API request

Point the Universal Web Scraper API at any TVmaze page and get structured JSON back. You supply the URL; Chocodata handles the blocks, rotation, and retries that make scrape tvmaze hard to run yourself.

  • check_circle JSON in the parse mode you choose
  • check_circle Residential-proxy infrastructure
  • check_circle Only successful 2xx responses are billed
Get your free API key

Request

curl "https://api.chocodata.com/api/v1/universal/get?api_key=YOUR_API_KEY&url=https://www.tvmaze.com/"

Response

{
  "success": true,
  "url": "https://www.tvmaze.com/",
  "status": 200,
  "content": "parsed TVmaze page content..."
  // + more fields
}

Parameters

TVmaze routes through the Universal Web Scraper API, so the parameters are the universal ones: the URL to fetch, an optional parse mode, and an optional country for proxy geo-targeting.

Parameter Type Required Example
url string required https://example.com
parse enum optional auto
country string optional us

Enum parameters accept a fixed set of values. For example, parse accepts auto, html, text, json.

What you can build with TVmaze data

Once the scraping API returns TVmaze search data as clean JSON, these are the patterns teams reach for most.

check_circle

Catalog And Metadata Aggregation

Feed TVmaze search data into your own product or workflow for catalog and metadata aggregation.

check_circle

Ratings And Review Analysis

Feed TVmaze search data into your own product or workflow for ratings and review analysis.

check_circle

Content Discovery

Feed TVmaze search data into your own product or workflow for content discovery.

check_circle

Trend Tracking

Feed TVmaze search data into your own product or workflow for trend tracking.

Why developers pick Chocodata for TVmaze

bolt

Fast at the tail

Median 2.6 s per request with multi-tier retry, so latency stays predictable even when TVmaze fights back.

verified_user

Parity-checked output

The Universal scraper returns the live page faithfully in your chosen parse mode.

hub

One key, 235 targets

The same scraping API key that scrapes TVmaze works across every other target, with official Node, Python, and Go SDKs.

Simple pricing that scales with you

Start free with 1,000 requests a month and 5,000 credits, no credit card. Scale on monthly plans from $19, or top up pay-as-you-go at $0.90 per 1,000 successful requests. Only successful 2xx responses are billed, and every plan covers the full scraping API: all 235 targets and every endpoint.

Free

$0

Forever free on signup

  • check_circle1,000 requests / month (5,000 credits)
  • check_circle10 concurrent requests
  • check_circleAll 237 targets
  • check_circleFull dashboard + analytics
  • check_circleTop-up at $0.90 / 1k
  • check_circleCommunity support
Start free
Most popular

Vibe

$19 / month

$0.70 / 1k effective

  • check_circle27,000 requests / month (135,000 credits)
  • check_circle30 concurrent requests
  • check_circleAll 237 targets + content-language
  • check_circleCountry-matched residential IPs
  • check_circlePer-API-key usage tracking
  • check_circleTop-up at $0.90 / 1k
  • check_circleEmail support (1 business day)
Get Vibe

Pro

$49 / month

$0.60 / 1k effective

  • check_circle82,000 requests / month (410,000 credits)
  • check_circle50 concurrent requests
  • check_circlePriority routing queue
  • check_circleCountry-matched residential IPs
  • check_circleTeam seats (up to 5)
  • check_circleTop-up at $0.90 / 1k
  • check_circleEmail + chat support
Get Pro

Custom

$100-$2k / month

Flat $0.50 / 1k effective at every level

  • check_circle200k - 4M+ requests / month
  • check_circle100-500+ concurrent requests
  • check_circlePriority queue (highest)
  • check_circlePremium proxy pool + SLA on request
  • check_circleUnlimited team seats
  • check_circleWire / invoice / annual PO
  • check_circleDedicated Slack channel
Pick Custom level

Pay-as-you-go top-up

$0.90 / 1,000 successful requests

Available on every plan including Free. Top up any time when included credits run out. Only 2xx responses charged. Balance never expires.

TVmaze Scraper API FAQ

Is it legal to scrape TVmaze?

expand_more
Scraping publicly accessible TVmaze data is generally legal in the US under the Ninth Circuit's hiQ v. LinkedIn ruling, which held that scraping public web data does not violate the Computer Fraud and Abuse Act. It does not override TVmaze's own Terms of Service, which are a contract matter, so check those for your use case and comply with data laws such as GDPR. This is general information, not legal advice.

How do I scrape TVmaze without getting blocked?

expand_more
You scrape TVmaze without getting blocked by sending the URL to the Universal Web Scraper API, which fetches it through rotating residential proxies and retries on soft blocks. Your own IP is never used, so TVmaze's anti-bot layer sees ordinary residential traffic instead of a server.

What data does the TVmaze Scraper API return?

expand_more
Through the Universal Web Scraper API you get the TVmaze page back as JSON: rendered HTML, plain text, or auto-parsed content depending on the parse mode you pass. You choose the URL, Chocodata returns the data.

How much does the TVmaze Scraper API cost?

expand_more
The TVmaze Scraper API costs nothing to start: the Free plan includes 1,000 requests per month (5,000 credits) across all 235 targets. After that, monthly plans begin at $19, or you top up pay-as-you-go at $0.90 per 1,000 successful requests. One request is 5 credits, and non-2xx responses are never charged.

Do I need a TVmaze account or login?

expand_more
No TVmaze login is needed for public pages. You point the Universal Web Scraper API at a publicly accessible TVmaze URL with your Chocodata API key; you do not hand over any TVmaze credentials. Login-gated content is not supported.

Related scraper APIs

Start scraping TVmaze for free

1,000 free scraping API requests on signup across all 235 targets. No credit card required.