Docs
History
Schema
Generate

Filter operations

get/okf/{arquivo}OKF bundle (Open Knowledge Format v0.1): Markdown with frontmatter, so that an agent reads the whole product without parsing HTML.
get/.well-known/{arquivo}Machine discovery before the home page: `api-catalog` (RFC 9727, linkset with the API and the MCP), `security.txt` (RFC 9116), `x402` (payment manifest: network, wallet and the routes that charge), `agent-card.json` (agent identity: MCP tools and discovery entry points; also at `/agent.json`) and `mcp-registry-auth` (key of the official MCP registry).
get/apis.jsonAPIs.json (apisjson.org, 0.19): the index that APIs.io collects, with the API, the MCP, OpenAPI, guide and OKF bundle in a single file. Also at `/.well-known/apis.json`.
get/agent.jsonAgent card: identity, operator, documentation, the MCP endpoint and the tools it serves. Same document as `/.well-known/agent-card.json`.
get/api/Self-describing index of the whole API, with the languages and the HTML pages of each one.
get/api/healthLiveness and the commit published now: this is how the smoke test waits for its own deploy.
post/mcpMCP server over HTTP (Streamable HTTP, JSON-RPC 2.0): it connects to the client with nothing to install.
get/api/channelsPaginated search of the public catalog, with the category facets of the current search.
get/api/channels/{id}Full record of a channel, with the streams already pointing to our hop.
get/api/channels/{id}/healthWhy the channel fails, for whom and where: it includes geo-blocking, latency per region and the caller's verdict.
get/api/channels/{id}/guiaToday's schedule of the channel, grabbed by us: what is on air now and what comes next.
get/api/geoCountry and language suggested for the caller.
get/api/countriesCountries that have a playable channel, with the count and the flag of each one.
get/api/tagsTags of the playable radio stations (free vocabulary), with the count of each one.
get/api/categoriesCategory vocabulary of the catalog, with an icon for the interface.
post/api/categoriesCreates a folder in the gallery, already with the General sub-tab inside it.
get/api/languagesLanguages that have a playable channel, with the count of each one.
get/api/networksNetworks and broadcasters that have a playable channel, with the count.
get/api/qualitiesDistinct qualities found in the catalog streams (for radio, codec and bitrate).
get/api/subdivisionsStates and provinces that have a playable channel.
get/api/citiesCities that have a playable channel, filterable by country and by state.
get/api/programacaoChannels with a collected schedule, up to 48 per page.
get/api/programacao/{slug}Last available schedule of the channel and up to 20 dates of the history.
get/api/programacao/{slug}/{dia}Preserved schedule of a channel on a specific day.
get/api/producersOffer on request for producers with authorized content, and contact channels.
get/logos/{id}Channel logo served by us, in the card variant (≤256px).
get/api/s/{id}Stream hop: the public URL points to https://m3m8.gradetv.net; the apex still answers 302 for compatibility. Media stays direct. It counts the play once per person, channel and day.
get/api/legacy/{id}Public metadata for the legacy HTTP player, without a session.
get/api/m/{ticket}Turned off: it was the video pass-through. It always answers 410.
get/f/{token}/library.{formato}Feed of the owner's whole library, in the format that the extension requests.
get/f/{token}/c/{categoria}.{formato}Feed of one folder of the library, to subscribe only to that segment.
get/f/{token}/c/{categoria}/g/{grupo}.{formato}Feed of a sub-tab: the finest segment that the gallery offers.
get/payOpens the pass payment with the code shown on the TV.
get/api/tv/tela.jsLoads the global behavior of the activation screen.
get/api/tv/{codigo}/estadoChecks the TV activation without using minutes.
get/api/tv/{codigo}/wsFollows the confirmation through the WebSocket.
post/api/tv/{codigo}/comprarBuys the TV network pass: 30 days for 0.10 USDC, 90 for 0.29 or 365 for 0.99.
get/api/tv/{codigo}/aviso.{formato}Image or video of the Grade with a QR and a payment code.
get/api/tv/hop/playlistPrivate capability of the list server to check the allowance and the pass.
post/api/guestCreates a guest `ipt_…`: it is the identity that keeps the gallery, history and favorites without an account.
get/api/keysRetirada: listava as chaves `iptk_…`. Responde 410.
post/api/keysRetirada: criava chave `iptk_…`. Responde 410.
delete/api/keys/{id}Retired: it revoked an `iptk_…` key. It answers 410.
get/api/nsfw/passRetired: it read the adult content pass. It answers 410.
post/api/nsfw/passRetired: it bought the adult content pass. It answers 410.
get/api/libraryThe owner's whole gallery: folders, sub-tabs, channels and the feed URLs of each level.
delete/api/categories/{id}Deletes the folder and everything inside it: sub-tabs and channels.
patch/api/categories/{id}Renames a folder. The feed slug follows the new name.
post/api/groupsCreates a sub-tab inside a folder.
delete/api/groups/{id}Deletes a sub-tab and the channels that were in it.
post/api/itemsPuts a catalog channel in a sub-tab of the gallery.
delete/api/items/{id}Removes a channel from the sub-tab. The channel stays in the public catalog, of course.
post/api/items/{id}/playMarks this channel as the last one played in the sub-tab; this is what returns the person to where they stopped.
get/api/historyChannels the owner watched, from the most recent to the oldest.
post/api/historyRecords that the owner watched a channel. Repeating adds to `plays` and moves the row up.
delete/api/historyClears the owner's whole history, at once.
delete/api/history/{channel_id}Removes a channel from the owner's history.
post/api/play-reportTells whether the channel played or failed.
get/api/play-reportsReads individual playback reports. Operator access only.
get/api/favoritesChannels the owner marked as favorite, from the most recent to the oldest.
post/api/favoritesMarks a channel as favorite. Repeating does not add: the public counter counts people, not clicks.
delete/api/favorites/{channel_id}Removes the channel from favorites and gives the point back to the public counter.
get/api/channels/{id}/commentsPublic comments of a channel, from the newest to the oldest.
post/api/channels/{id}/commentsWrites a comment on the channel. Cap of 20 per hour per owner.
delete/api/comments/{id}Deletes one of your comments. Another person's comment answers 404, not 403.
get/api/chat/{channel_id}/mensagensLatest messages of the channel room, plus the WebSocket address to follow live.
post/api/chat/{channel_id}/mensagensSends a message to the room without opening a WebSocket. It requires the monthly chat pass.
post/api/chat/passBuys or confirms the monthly chat pass: $0.10 per 30 days, through x402 or credit.
get/api/chat/{channel_id}/wsWebSocket of the channel room: the live path, with presence.
get/api/auth/bootstrapPrepares the browser to sign in to the global account.
get/api/account/profileReads your global profile.
get/api/account/avatarGets your global profile photo.
post/api/auth/logoutRevokes this product session.
get/api/account/keysLists your API keys in this product.
post/api/account/keys/createCreates an API key for agents and scripts.
post/api/account/keys/revokeRevokes one of your API keys.
get/api/account/appsLists the apps connected to your account in this product.
post/api/account/apps/revokeDisconnects an app from your account.
post/api/auth/wallet/agent/startStarts the wallet credential of an agent without an account.
post/api/auth/wallet/agent/tokenGets the wallet credential (mmw_…) of this product.
post/api/auth/claim/walletsMoves to the account what its wallets did without an account.
post/api/auth/claimMoves to the account what the guest created: folders (with the sub-tabs and channels), favorites, history, comments and the feed link.
get/api/meThe session account: e-mail and the size of its library.
get/api/billingPrices in force, gallery caps and the full x402 configuration.
post/api/contactTalk to the people who make the product, free of charge, for people and agents.
post/api/visitThe screen notice that adds a visit to the day. Agents do not need to call it.
post/api/erro-clienteBrowser error report, sent by the interface itself. Agents do not need to call it.
post/api/pagamento/abertoThe interface reports that it showed a charge. Agents must not call it.
post/api/funilThe interface reports the steps of the visit (conversion funnel). Agents must not call it.
get/api/funil/arquivosOperator: the days of the funnel log stored in this app, with the size of each one.
get/api/funil/arquivoOperator: a part of one day of the funnel log, in NDJSON, from a given byte.
get/api/vitrineThe public numbers of the product: traffic, agents, usage and reliability, without money.
get/api/vitrine/operadorThe full document of the product in the operator dashboard, only with the operator token.
get/api/vitrine/painelThe dashboard of the whole house, in the shape that gm reads, only with the operator token.
get/api/vitrine/cursoresThe resolved-error cursor per product (`borda`, `cli`), only with the operator token.
get/api/partnersPartnership, sponsorship and ads: the product slots with a suggested price, the public numbers next to them and how to propose.
get/api/metricsMetrics of the last 7 days. With the operator token, they include the payments.
get/api/admin/catalogo/estadoCounts of the live catalog and of the staging, plus the stamp of the last reload.
get/api/admin/catalogo/slugsPublished slug of each channel, paginated by ID: the reload inherits it so that an indexed URL does not change.
post/api/admin/catalogo/inicioOpening staging was retired and answers 410.
post/api/admin/catalogo/loteSending a batch to staging was retired and answers 410.

Changes to Disconnects an app from your account.

post/api/account/apps/revoke

Oct 16, 20260cf3b28e1c16 Revision changes
- info
  endpoint added