Começando
Aprenda como fazer sua primeira requisição à API e comece a buscar dados de notícias.
Bem-vindo(a) à AllNewsAPI! Este guia irá apresentar os conceitos básicos de como usar nossa API para buscar artigos de notícias do mundo todo.
1. Obtenha sua chave de API
Primeiro, você precisará de uma chave de API para autenticar suas solicitações. Cadastre-se para obter uma conta gratuita e receba sua chave de API instantaneamente.
2. Faça seu primeiro pedido
Depois de obter sua chave de API, você pode fazer sua primeira solicitação à API. Aqui está um exemplo simples para pesquisar artigos de notícias:
3. Compreenda a resposta
A API retorna uma resposta JSON contendo uma matriz de artigos de notícias. Cada artigo inclui as seguintes propriedades:
Nome | Tipo | Valor padrão | Descrição |
|---|---|---|---|
totalArticles | integer | — | O número total de artigos que correspondem à sua pesquisa. |
currentPage | integer | — | O número da página atual nos resultados paginados. |
nextPage | integer | — | O número da próxima página (nulo se for a última página) |
articles | array | — | Uma lista de objetos de artigo que correspondem aos seus critérios de pesquisa. |
articles[].title | string | — | O título do artigo de notícias |
articles[].description | string | — | A descrição ou resumo do artigo de notícias |
articles[].category | string | — | A categoria à qual o artigo pertence. |
articles[].content | string | — | Conteúdo completo da notícia (recurso premium) |
articles[].country | string | — | Código do país onde o artigo foi publicado (ISO 3166-1 alfa-2) |
articles[].region | string | — | A região geográfica onde o artigo foi publicado. |
articles[].lang | string | — | Código de idioma do artigo (ISO 639-1) |
articles[].authors | array | — | Conjunto de nomes de autores de artigos |
articles[].ai_sentiment | string | — | Rótulo de sentimento detectado por IA (positivo, negativo ou neutro). Disponível apenas em planos pagos. |
articles[].ai_sentiment_scores | object | — | Objeto contendo os índices de confiança para cada categoria de sentimento. Disponível apenas em planos pagos. |
articles[].ai_entities | array | — | Matriz de entidades nomeadas extraídas com campos de nome e tipo. Disponível apenas em planos pagos. |
articles[].ai_summary | string | — | Resumo do conteúdo do artigo gerado por IA. Disponível apenas em planos pagos. |
articles[].url | string | — | O link direto para o artigo original. |
articles[].image | string | — | O URL da imagem principal ou da miniatura do artigo |
articles[].publishedAt | string | — | Data e hora de publicação do artigo no formato ISO 8601 (UTC) |
articles[].source.name | string | — | O nome do editor ou fonte da notícia. |
articles[].source.url | string | — | O URL da página inicial da fonte de notícias. |
O plano gratuito inclui acesso a dados de notícias em tempo real, até 50 solicitações por dia e 7 dias de dados históricos. Não é necessário cartão de crédito!
Próximos passos
Agora que você fez sua primeira solicitação, explore estes guias para saber mais: