Você precisa implementar um recurso que traga notícias frescas e específicas de seções (por exemplo: “Tecnologia → IA” ou “Mundo → Oriente Médio”) sem construir um scraper personalizado ou lidar com múltiplos feeds. Ao final deste artigo, você saberá exatamente qual endpoint chamar para buscar notícias de tópicos por seção, como filtrar por país e idioma, e como integrá-lo ao seu aplicativo usando um snippet de curl ou Python que pode ser copiado e colado.
O que esta API faz e por que é útil
A API de Dados de Notícias em Tempo Real no Zyla API Hub fornece dados de notícias estruturados que você pode consultar de três maneiras:
- Pesquisa: pesquisa baseada em palavras-chave em artigos de notícias.
- Destaques: últimas principais histórias por país (e idioma/límite opcionais).
- Notícias de Tópicos por Seção: artigos dentro de uma seção específica de um tópico (por exemplo, Tecnologia) ou de uma publicação (por exemplo, CNN, BBC).
Esses endpoints retornam campos normalizados como título, link, snippet, URLs de mídia, autores, detalhes da fonte e um timestamp UTC. Casos de uso típicos incluem widgets de notícias personalizados, painéis editoriais, alertas automatizados ou enriquecimento para sistemas de recomendação de conteúdo.
Se você é novo no Zyla, é um marketplace de APIs com mais de 10.000 APIs públicas e uma maneira padronizada de autenticar e assinar. Você pode explorar categorias e provedores diretamente no Zyla API Hub, e então conectar a mesma chave de API em qualquer listagem à qual você se inscrever.
Começando no Zyla API Hub
Abra a página da API de Dados de Notícias em Tempo Real e comece um teste. O Zyla utiliza um modelo de assinatura + cota (não pago por chamada). Para sua primeira API, você pode iniciar um teste de 7 dias ou 50 requisições. Não há Plano Gratuito. Após se inscrever, você receberá uma chave de API utilizável em todos os endpoints desta API.
- Vá para a listagem: Iniciar teste de 7 dias na API de Dados de Notícias em Tempo Real
- Clique em Assinar (ou Iniciar Teste Gratuito, se disponível) e obtenha sua chave de API.
- Use Authorization: Bearer YOUR_API_KEY em cada requisição.
Precisa avaliar outros conjuntos de dados depois? Você pode navegar e se inscrever em mais listagens em zylalabs.com com a mesma conta e autenticação padrão.
Endpoints que você usará
1) Notícias de Tópicos por Seção
Use isso para obter artigos dentro de uma seção específica de um tópico (como “Mundo, Esportes, Tecnologia”) ou de uma publicação (como CNN, BBC). Esta é a maneira mais direta de implementar “API para notícias de tópicos por seção.”
- Método: GET
- URL: https://zylalabs.com/api/7339/real-time-news-data-api/11656/topic-news-by-section
- Descrição: Obter artigo de notícias em uma seção específica de um tópico (Mundo, Esportes, Tecnologia, etc) ou publicação (CNN, BBC, etc).
- Parâmetros de requisição:
- tópico (string, obrigatório): por exemplo, TECNOLOGIA
- seção (string, obrigatório): identificador de seção opaco
- limite (número, opcional): por exemplo, 500
- país (string, opcional): por exemplo, US
- idioma (string, opcional): por exemplo, en
Exemplo de curl (copie e cole e substitua YOUR_API_KEY):
curl -s -X GET "https://zylalabs.com/api/7339/real-time-news-data-api/11653/search?query=Elon+Musk" \
-H "Authorization: Bearer YOUR_API_KEY"
Notas:
- Os valores published_datetime_utc são timestamps ISO-8601 em UTC.
- Filtre por país e idioma se precisar de seções localizadas ou quiser restringir resultados.
- O parâmetro de seção é um identificador opaco obrigatório. Use o valor que você pretende direcionar para o tópico ou publicação escolhida.
2) Pesquisa
Encontre artigos por um termo de pesquisa. Útil para validar seu feed baseado em seções ou preencher lacunas com conteúdo correspondente a palavras-chave.
- Método: GET
- URL: https://zylalabs.com/api/7339/real-time-news-data-api/11653/search
- Descrição: Pesquisar artigos de notícias por consulta com uma opção para limitar os resultados a um intervalo de tempo específico.
- Parâmetros de requisição:
- consulta (string, obrigatório): por exemplo, Elon Musk
Exemplo oficial de curl (copie e cole exatamente isso):
Exemplo de resposta oficial (campos que você pode analisar como título, link, published_datetime_utc, autores, source_name):
{
"status": "OK",
"request_id": "1254b56e-7238-4807-9fa7-bd9256c0b66c",
"data": [
{
"title": "Como as raízes da ‘mafia do PayPal’ se estendem até a África do Sul do apartheid",
"link": "https://www.theguardian.com/technology/2025/jan/26/elon-musk-peter-thiel-apartheid-south-africa",
"snippet": "Musk faz parte da “mafia do PayPal” de bilionários libertários com raízes na África do Sul sob o domínio branco agora extremamente influente na tecnologia dos EUA ...",
"photo_url": "https://i.guim.co.uk/img/media/01d10e660767815cd5799030b4ff658664343b13/1_0_2998_1800/master/2998.jpg?width=465&dpr=1&s=none&crop=none",
"thumbnail_url": "https://news.google.com/api/attachments/CC8iL0NnNXphbFpzWm10S09YQnVSWGxTVFJDWEFoalJBeWdLTWdrQklKcEdIcWtXWndJ=-w200-h200-p-df-rw",
"published_datetime_utc": "2025-01-26T16:00:00.000Z",
"authors": [
"Chris McGreal"
],
"source_url": "https://www.theguardian.com",
"source_name": "The Guardian",
"source_logo_url": "https://lh3.googleusercontent.com/SU8FywVNtcrG-wgjvZ_0D1-3JR_pN9LNSgjULFH74N748KVyEdkF1jdbvP4Lr7_ClbPZxL-iPw",
"source_favicon_url": "https://encrypted-tbn0.gstatic.com/faviconV2?url=https://www.theguardian.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"source_publication_id": "CAAqBggKMJeqezDfswk",
"related_topics": [
{
"topic_id": "CAAqIggKIhxDQkFTRHdvSkwyMHZNR1ppWm13MUVnSmxiaWdBUAE",
"topic_name": "Chris McGreal"
}
]
},
{
"title": "Bill Gates diz que acha 'insano' que Elon Musk possa 'desestabilizar' a política em outros países",
"link": "https://www.businessinsider.com/gates-its-insane-that-musk-can-destabilize-foreign-politics-2025-1",
"snippet": "Bill Gates não gosta de como Elon Musk se envolveu na política de países estrangeiros como o Reino Unido e a Alemanha.",
"photo_url": "https://i.insider.com/679751e2eb4be2fff9a22f97?width=700",
"thumbnail_url": "https://news.google.com/api/attachments/CC8iI0NnNVpaRXhyYlRkVE9WRXhTbnB3VFJEZ0F4aUFCU2dLTWdB=-w200-h200-p-df-rw",
"published_datetime_utc": "2025-01-27T09:36:00.000Z",
"authors": [
"Kevin Tan"
],
"source_url": "https://www.businessinsider.com",
"source_name": "Business Insider",
"source_logo_url": "https://lh3.googleusercontent.com/MD0yHuvt1mX8YyHUcdTCsQqMKGubFCwbWmpxzkT1xnE5wZ4aDRmb2zvkgfgG_b0mHNhaSxqO2A",
"source_favicon_url": "https://encrypted-tbn3.gstatic.com/faviconV2?url=https://www.businessinsider.com&c…
Notas de campo que você provavelmente usará:
- título, link, snippet: para renderizar o cartão ou pré-visualização.
- photo_url, thumbnail_url: ativos de imagem quando disponíveis.
- published_datetime_utc: timestamp ISO-8601 UTC que você pode converter para o horário local.
- autores, source_name: atribuição e rotulagem.
3) Principais Manchetes
Busque rapidamente as últimas manchetes por país, com parâmetros opcionais de idioma e limite.
- Método: GET
- URL: https://zylalabs.com/api/7339/real-time-news-data-api/11654/top-headlines
- Descrição: Obter as últimas manchetes de notícias/principais histórias para um país.
- Parâmetros de requisição:
- limite (número, opcional): por exemplo, 500
- país (string, opcional): por exemplo, US
- lang (string, opcional): por exemplo, en
Exemplo de curl:
Exemplo em Python: buscar notícias de tópicos por seção
Este script chama o endpoint de Notícias de Tópicos por Seção e, em seguida, imprime os campos essenciais. Substitua YOUR_API_KEY pela sua chave e ajuste tópico/seção/país/idioma para o seu caso de uso.
import os
import requests
API_KEY = os.getenv("ZylaApiKey", "YOUR_API_KEY")
url = "https://zylalabs.com/api/7339/real-time-news-data-api/11656/topic-news-by-section"
params = {
"topic": "TECHNOLOGY",
"section": "CAQiSkNCQVNNUW9JTDIwdk1EZGpNWFlTQldWdUxVZENHZ0pKVENJT0NBUWFDZ29JTDIwdk1ETnliSFFxQ2hJSUwyMHZNRE55YkhRb0FBKi4IACoqCAoiJENCQVNGUW9JTDIwdk1EZGpNWFlTQldWdUxVZENHZ0pKVENnQVABUAE",
"limit": 50,
"country": "US",
"language": "en",
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
if data.get("status") == "OK":
for item in data.get("data", []):
title = item.get("title")
link = item.get("link")
published = item.get("published_datetime_utc")
source = item.get("source_name")
print(f"[{published}] {title} — {source} :: {link}")
else:
print("Status não OK:", data)
Dicas de implementação:
- Armazene em cache as respostas por um curto período com base nas necessidades da sua interface para evitar buscas redundantes quando os usuários atualizam frequentemente.
- Respeite o modelo de assinatura + cota; evite polling desnecessário em cada visualização de página. Distribua no lado do servidor conforme necessário.
- Os timestamps estão em UTC; converta uma vez na sua camada de API/serviço para evitar lógica de fuso horário repetida no cliente.
Casos de uso práticos que você pode implantar esta semana
- Páginas de destino de tópicos: Direcione seções “Tecnologia → IA” ou “Esportes → Futebol” do endpoint de Notícias de Tópicos por Seção com filtros de país/idioma para localização.
- Preenchimento editorial: Quando uma seção tem menos histórias do que o esperado, execute a Pesquisa como uma alternativa para palavras-chave específicas e mescle os resultados no feed.
- Monitores de mercado/setor: Combine artigos da seção de Tecnologia com Pesquisa para empresas nomeadas para alimentar painéis de investidores.
- Alertas/notificações: Monitore seções relevantes para seus usuários e envie atualizações quando novos artigos aparecerem (compare link ou título com seu conjunto de últimos vistos).
Chamando a API de um agente de IA (MCP)
Você também pode chamar as APIs do Zyla através de clientes compatíveis com MCP (por exemplo, Claude Code, Cursor, Windsurf) usando o endpoint MCP. Direcione seu agente ou ferramenta para:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
A partir daí, emita as mesmas requisições HTTP GET mostradas acima com o cabeçalho de Autorização. Para mais informações sobre o transporte MCP, veja MCP.
Detalhes operacionais que economizam tempo
- Auth: Use o cabeçalho HTTP Authorization: Bearer YOUR_API_KEY para cada requisição.
- Timestamps: published_datetime_utc está em UTC (ISO-8601). Normalize cedo em seu pipeline.
- Filtragem: Para Notícias de Tópicos por Seção, tópico e seção são obrigatórios. país e idioma são refinamentos opcionais; use limite para limitar o tamanho da carga.
- Cotas: A cobrança do Zyla é por assinatura + cota. Para a primeira API, você pode iniciar um teste de 7 dias ou 50 requisições. Verifique a página da API para opções de acesso e preços atuais após o teste.
- Modelo de dados: Objetos de artigo incluem source_name, source_url e listas de autores para suportar a atribuição adequada em sua interface.
Fluxo de ponta a ponta para implementar o recurso
- Inicie um teste da API de Dados de Notícias em Tempo Real e obtenha sua chave de API: Iniciar teste de 7 dias na API de Dados de Notícias em Tempo Real.
- Escolha o tópico e o identificador de seção que deseja alimentar (por exemplo, TECNOLOGIA + o valor de seção necessário).
- Chame o endpoint de Notícias de Tópicos por Seção no lado do servidor com Authorization: Bearer YOUR_API_KEY.
- Renderize título, link, snippet, photo_url/thumbnail_url e source_name. Converta published_datetime_utc para o fuso horário dos seus usuários.
- Adicione um cache leve ou equivalente a ETag do seu lado para eliminar chamadas redundantes na atualização.
- Opcionalmente, adicione Pesquisa para preencher lacunas ou criar detalhamentos por palavra-chave.
FAQ
Como eu me autentico?
Inclua o cabeçalho Authorization: Bearer YOUR_API_KEY em cada requisição.
Qual endpoint retorna notícias de tópicos por seção?
GET https://zylalabs.com/api/7339/real-time-news-data-api/11656/topic-news-by-section com parâmetros obrigatórios de tópico e seção. Parâmetros opcionais incluem limite, país e idioma.
Em que fuso horário estão as datas de publicação?
published_datetime_utc é fornecido em UTC (ISO-8601). Converta-o na sua camada de cliente ou servidor conforme necessário.
Posso também buscar manchetes gerais por país?
Sim. Use GET https://zylalabs.com/api/7339/real-time-news-data-api/11654/top-headlines com parâmetros opcionais de limite, país e lang.
Como eu chamo isso de um assistente ou agente de código de IA?
Use o transporte MCP em https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY em um cliente compatível com MCP, e então emita as mesmas requisições GET com o cabeçalho de Autorização. Veja MCP.
Pronto para implementar notícias baseadas em seções hoje? Inicie seu teste, obtenha sua chave e conecte o endpoint de Notícias de Tópicos por Seção aqui: Iniciar teste de 7 dias na API de Dados de Notícias em Tempo Real.