Busca paginada do catálogo público, com as facetas de categoria da busca atual.

É a porta de entrada do produto. A resposta varia por navegador, sistema e país de quem pede — cada canal traz social.your_fails, o recorte do SEU ambiente — por isso ela é Cache-Control: private. Devolve: { items[{id,name,alt_names,country,categories,category_labels,languages,language_labels,logo_url,website,playable_hint?,slug,network,owners,launched,replaced_by,feed_name,feed_format,timezones,broadcast_area,quality?,has_guide,guide_site,guide_lang,subdivision,city,kind,radio?,origem,guide_now?,health_ext,social?,api}], total, limit, offset, next_offset, facets{categories}, filters{q,country,category,language,network,quality,guide,subdivision,city,playable,sort,online,kind,tag} }

get/api/channels

Request

  • Base URL: https://gradetv.net
  • URL: https://gradetv.net/api/channels
  • Auth: none required

Query parameters

qstring

Texto livre no nome e nos apelidos do canal (busca full-text).

countrystring

País do canal, ISO 3166-1 alpha-2.

categorystring

ID de categoria do catálogo.

languagestring

Idioma do canal, ISO 639-3.

networkstring

Nome exato da rede/emissora.

qualitystring

Qualidade exata do stream.

guideboolean

1 traz só canal com grade de programação (EPG).

subdivisionstring

Estado/província, código do catálogo.

citystring

Cidade, código do catálogo.

playableboolean

0 inclui canal sem stream utilizável conhecido.

sort'name' | 'score' | 'votes'

score ordena pela saúde medida por terceiro, melhor primeiro; canal não medido vai para o fim. votes ordena pelos votos registrados para a estação (rádio). name é a ordem alfabética.

onlineboolean

1 traz só canal visto online pela fonte nas 48 h anteriores à última recarga do catálogo (health_ext.online); com o catálogo parado há mais de 48 h o filtro não devolve ninguém.

kind'tv' | 'radio' | 'all'

tv (padrão) é o catálogo de TV; radio são as estações de rádio; all junta os dois. Sem kind, rádio nunca aparece.

tagstring

Tag da estação de rádio (vocabulário livre, ex. mpb, news); veja GET /api/tags.

limitinteger

Itens por página. Acima de 50 é silenciosamente reduzido a 50.

offsetinteger

Quantos itens pular. Use next_offset da resposta anterior.

Response

{ items[{id,name,alt_names,country,categories,category_labels,languages,language_labels,logo_url,website,playable_hint?,slug,network,owners,launched,replaced_by,feed_name,feed_format,timezones,broadcast_area,quality?,has_guide,guide_site,guide_lang,subdivision,city,kind,radio?,origem,guide_now?,health_ext,social?,api}], total, limit, offset, next_offset, facets{categories}, filters{q,country,category,language,network,quality,guide,subdivision,city,playable,sort,online,kind,tag} }

totalinteger required

Canais que casam com o filtro, ignorando a paginação.

limitinteger required

Tamanho de página aplicado (teto de 50).

offsetinteger required

Deslocamento aplicado nesta página.

next_offsetinteger nullable required

Offset da próxima página; null quando acabou.

Changes

No recorded changes to this operation across all 1 revision of this API.