API para YouTube
API para YouTube: Lives do canal
Liste as transmissões ao vivo atuais e passadas de um canal do YouTube por nome de usuário ou ID do canal, com paginação por cursor (título, visualizações, duração, data de publicação).
POST/v1/run/youtube.channel_lives
Disponibilidade
100,00%
30d · 2 chamadas
Requisições
2
30d
Resposta
1,0s
mediana · 30d
Rede de provedores
Provedores ordenados por tráfego
Teste
Faça sua primeira requisição
requireFieldsarrayOpcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `lengthText`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em uma transmissão ao vivo que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança. Ao paginar, vale só para a primeira página; as páginas seguintes continuam na fonte que a primeira página escolheu, pelo preço cotado.
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
"data": {
"lives": [
{
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"lengthText": "A short example description of this item.",
"publishedTime": "2024-01-15T09:30:00Z",
"title": "Example title",
"url": "https://example.com/page",
"views": 12500
}
],
"nextCursor": "example"
},
"found": true,
"reason": "not_found"
}Interface da resposta
interface YoutubeChannelLivesResponse {
data: {
lives: {
id: string;
image?: string;
lengthText: string | null;
publishedTime: string;
title: string;
url: string;
views: number;
}[];
nextCursor: string | null;
} | null;
found: boolean;
reason?: "not_found";
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Requisição, resposta e preço
Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30dPOST /v1/run/youtube.channel_lives
curl -X POST https://api.getanyapi.com/v1/run/youtube.channel_lives \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"handle":"@IShowSpeed"}'| Campo | Tipo | Valor de exemplo |
|---|---|---|
| Corpo da requisição | ||
| channelId | string | ID do canal do YouTube. |
| cursor | string | Token de continuação de uma resposta anterior, para paginação. |
| handle | string | "@IShowSpeed"Nome de usuário do canal do YouTube. |
| requireFields | array | Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `lengthText`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em uma transmissão ao vivo que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança. Ao paginar, vale só para a primeira página; as páginas seguintes continuam na fonte que a primeira página escolheu, pelo preço cotado. |
| Resposta | ||
| data | object | |
| data.lives | object[] | Populated whenever the provider has data for the entity. |
| data.lives[].id | string | Populated whenever the provider has data for the entity. |
| data.lives[].image | string | URL of the live stream thumbnail image, tracking query parameters stripped. |
| data.lives[].lengthTextpode ser exigido | string | Stream length as YouTube shows it, such as 3:29:31, or LIVE while it is streaming; null when the serving source does not report it. |
| data.lives[].publishedTime | string | Populated whenever the provider has data for the entity. |
| data.lives[].title | string | Populated whenever the provider has data for the entity. |
| data.lives[].url | string | Populated whenever the provider has data for the entity. |
| data.lives[].views | integer | Views of a past stream, or people watching a stream that is live now. Every source reads it from YouTube's rounded label ("60K watching" is 60000), so it is approximate. |
| data.nextCursor | string | Opaque cursor for the next page of live streams, or null when this lane has no more. Pass it back as cursor to continue. |
| found | boolean | |
| 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. |
| Preço | ||
| Preço por requisição | USD | US$ 0,0012 |
| Preço /mil req. | USD | US$ 1,20 |
Dúvidas frequentes
Sobre o endpoint Lives do canal da API para YouTube
O endpoint Lives do canal da AnyAPI para YouTube retorna dados de YouTube em JSON normalizado com uma chamada POST para /v1/run/youtube.channel_lives. Liste as transmissões ao vivo atuais e passadas de um canal do YouTube por nome de usuário ou ID do canal, com paginação por cursor (título, visualizações, duração, data de publicação). A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 1,20 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Lives do canal da API para YouTube feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,0 segundos, em 2 chamadas medidas.
Custa a partir de US$ 1,20 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.
Liste as transmissões ao vivo atuais e passadas de um canal do YouTube por nome de usuário ou ID do canal, com paginação por cursor (título, visualizações, duração, data de publicação). 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 Lives do canal da API para YouTube feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,0 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.
Mais para chamar
Outros endpoints de YouTube
Canala partir de US$ 0,50 /mil req.Vídeoa partir de US$ 0,90 /mil req.Transcrição de vídeoa partir de US$ 0,90 /mil req.Buscara partir de US$ 0,50 /mil req.Vídeos do canala partir de US$ 0,50 /mil req.Comentários do vídeoa partir de US$ 1,20 /mil req.Posts da comunidade do canala partir de US$ 1,20 /mil req.Contato do canala partir de US$ 71,80 /mil req.Playlists do canala partir de US$ 1,20 /mil req.Shorts do canala partir de US$ 1,20 /mil req.Respostas a comentáriosa partir de US$ 1,20 /mil req.Post da comunidadea partir de US$ 1,20 /mil req.Playlista partir de US$ 1,20 /mil req.Buscar hashtaga partir de US$ 1,20 /mil req.Buscar Shortsa partir de US$ 1,20 /mil req.Shorts em altaa partir de US$ 1,20 /mil req.Patrocinadores do vídeoa partir de US$ 1,20 /mil req.Transcrição de vídeo (versão completa)a partir de US$ 1,00 /mil req.