API para Telegram

API para Telegram: Canal

Get a public Telegram channel by username: name, bio, photo, verified badge, exact subscriber count, and how many photos, videos, files and links it has posted.

POST/v1/run/telegram.channel
Disponibilidade
100,00%
30d · 2 chamadas
Requisições
2
30d
Resposta
1,1s
mediana · 30d

Preços e provedores

Preços do endpoint Canal da API para Telegram: uma API, 3 provedores intercambiáveis

O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.

Provedor
1LemurAtende primeiroUS$ 1,10/mil req.flat2GiraffeReserva 1US$ 1,20/mil req.flat3FoxReserva 2US$ 3,60/mil req.flat
Você paga
US$ 11,00
US$ 1,10/mil req., só pelo que você usar. Sem plano mensal.
Suas primeiras 90 requisições são grátis com o saldo inicial de US$ 0,10.

Teste

Obtenha Canal do Telegram em uma só requisição

requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `photoCount`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a channel that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "data": {
    "avatarUrl": "https://example.com/image.jpg",
    "description": "A short example description of this item.",
    "fileCount": 12500,
    "handle": "alex_rivera",
    "linkCount": 12500,
    "photoCount": 12500,
    "subscribers": 12500,
    "title": "Example title",
    "url": "https://example.com/page",
    "verified": true,
    "videoCount": 12500
  },
  "found": true,
  "reason": "not_found"
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Uma requisição, um formato de resposta.

Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.

Última verificação em 2026-10-19 · disponibilidade e latência medidas em 30d

Corpo da requisição

JSON, enviado via POST para este endpoint.

  • handlestring

    telegram

    Public Telegram channel username, with or without the @ (e.g. "telegram"), or its t.me link.

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `photoCount`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a channel that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.

Você envia. Um corpo JSON pequeno. Os valores mostrados são exemplos para você trocar pelos seus.

Resposta

JSON, um valor de exemplo por campo.

datadata

The channel record, or null when nothing was found.

  • avatarUrlstring

    Channel photo URL. Temporary: Telegram's CDN link expires.

  • descriptionstring

    Channel bio as plain text; null when the channel has none.

  • fileCountintegerpode ser exigido

    Files the channel has posted, rounded by Telegram. Null when not shown or when this source does not report it.

  • handlestring

    Channel username, without the @. Populated whenever the provider has data for the entity.

  • linkCountintegerpode ser exigido

    Links the channel has posted, rounded by Telegram. Null when not shown or when this source does not report it.

  • photoCountintegerpode ser exigido

    Photos the channel has posted. Telegram rounds this count ("1.2K" becomes 1200). Null when not shown or when this source does not report it.

  • subscribersinteger

    Exact subscriber count, read from the channel's public t.me page. Null when Telegram does not show it. Populated whenever the provider has data for the entity.

  • titlestring

    Channel name. Populated whenever the provider has data for the entity.

  • urlstring

    The channel's t.me link.

  • verifiedboolean

    True when the channel carries Telegram's verified badge. Null when this source does not report it.

  • videoCountintegerpode ser exigido

    Videos the channel has posted, rounded by Telegram. Null when not shown or when this source does not report it.

top level
  • foundboolean

    True when the channel was found; false when no public channel has this username.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Você recebe. Campos nomeados e tipados, no mesmo formato, seja qual for a fonte que responder.

Dúvidas frequentes

Sobre o endpoint Canal da API para Telegram

O endpoint Canal da AnyAPI para Telegram retorna dados de Telegram em JSON normalizado com uma chamada POST para /v1/run/telegram.channel. Get a public Telegram channel by username: name, bio, photo, verified badge, exact subscriber count, and how many photos, videos, files and links it has posted. A AnyAPI distribui cada requisição entre 3 fontes, com failover automático quando uma falha. Custa a partir de US$ 1,10 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Canal da API para Telegram feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,1 segundos, em 2 chamadas medidas.

Custa a partir de US$ 1,10 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Get a public Telegram channel by username: name, bio, photo, verified badge, exact subscriber count, and how many photos, videos, files and links it has posted. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Canal da API para Telegram feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,1 segundos, em 2 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.

Sim. Uma conta nova da AnyAPI começa com US$ 0,10 de saldo grátis, sem cartão, o que cobre 90 chamadas de Canal do Telegram a US$ 0,0011 cada.

A AnyAPI consulta a próxima das suas 3 fontes na mesma requisição, começando pela mais barata, então a queda de uma fonte não derruba sua chamada.

Envie uma requisição POST para https://api.getanyapi.com/v1/run/telegram.channel com sua chave da AnyAPI em um cabeçalho "Authorization: Bearer" e a entrada como corpo JSON. A mesma chave e a mesma carteira funcionam em todos os endpoints da AnyAPI.

Não. Você adiciona dólares a um único saldo pré-pago da AnyAPI e cada requisição desconta dele. Não há plano mensal nem mínimo, e o mesmo saldo paga todos os endpoints da AnyAPI.

Sim. Instale @getanyapi/sdk pelo npm para TypeScript ou getanyapi pelo pip para Python. Os dois chamam todos os endpoints da AnyAPI com a mesma chave, e qualquer cliente HTTP também funciona.

Sim. Um agente pode se conectar ao servidor MCP da AnyAPI em https://api.getanyapi.com/mcp, ou criar a própria chave de teste grátis com um único POST sem autenticação para https://api.getanyapi.com/agent/signup e chamar este endpoint por HTTP.