# GradeTV Channel Schedule API

> GradeTV Channel Schedule API is a paid API for AI agents from gradetv.net, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-01).

Returns the full TV schedule for a specific channel for a given day, including program names, air times, and synopses

## Facts

- Endpoint: GET https://gradetv.net/api/x402/programacao/:slug?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gradetv-channel-schedule-api-acf41944
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_I4TesjJqBBBcMqMd40Zqw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gradetv-channel-schedule-api-acf41944
```

Example prompt: What's on TV today on the GloboNews channel? Pull up the full schedule with show times and descriptions using the channel slug 'globonews'.

## When to prefer this

Use this endpoint when you need structured, up-to-date TV schedule data for a specific Brazilian television channel, including program names, times, and synopses. Prefer this over screen-scraping or generic TV guide sites when you need machine-readable schedule data on a per-channel, per-day basis.

## Known failure modes

- Invalid or unknown channel slug returns an error or empty schedule
- Channel has no programming data available for the requested day
- Paid endpoint returns 402 Payment Required if no prepaid credits are available
- Rate limiting or quota errors if too many calls are made rapidly

## How this service works

Grade TV: up to seven days of one channel's TV schedule (programs, times and synopses) in one call, paid per call

## Output

A structured list of television programs scheduled for the day on the specified channel, including each program's name, start time, end time, and a synopsis or description of the content.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [],
     "properties": {
      "slug": {
       "type": "string",
       "description": "Slug persistido do canal, vindo da coleção."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "url": {
       "type": "string",
       "description": "Página pública."
      },
      "dias": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "dia": {
          "type": "string",
          "description": "Dia preservado, YYYY-MM-DD."
         },
         "programas": {
          "type": "array",
          "items": {
           "type": "object",
           "properties": {
            "fim": {
             "type": "string",
             "description": "Fim do programa, ISO 8601."
            },
            "desc": {
             "type": "string"
            },
            "inicio": {
             "type": "string",
             "description": "Começo do programa, ISO 8601."
            },
            "titulo": {
             "type": "string",
             "description": "Título como o site da programação escreve."
            },
            "categoria": {
             "type": "string",
             "description": "Categoria do site, quando ele dá."
            }
           },
           "description": "Um programa da grade do dia, com os instantes em ISO 8601 (UTC)."
          },
          "description": "Até 512 programas e 128 KiB de JSON, em ordem cronológica."
         }
        }
       },
       "description": "Até sete dias, o mais recente primeiro."
      },
      "canal": {
       "type": "object",
       "properties": {
        "id": {
         "type": "string",
         "description": "ID do catálogo."
        },
        "name": {
         "type": "string",
         "description": "Nome do canal."
        },
        "slug": {
         "type": "string",
       
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gradetv-channel-schedule-api-acf41944/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gradetv.net](https://www.zero.xyz/host/gradetv.net/llms.txt)