Ponto final de pesquisa
Pesquise artigos de notícias usando palavras-chave, filtros e sintaxe de consulta avançada.
O endpoint de Busca permite pesquisar artigos de notícias em todo o nosso banco de dados usando palavras-chave, frases e operadores de consulta avançados. Filtre os resultados por idioma, país, categoria, intervalo de datas e muito mais.
https://api.allnewsapi.com/searchParâmetros de consulta
Nome | Tipo | Valor padrão | Descrição |
|---|---|---|---|
apikeyObrigatório | string | — | Sua chave de API para autenticação. Obtenha sua chave de API no painel de controle. |
q | string | — | Este parâmetro permite que você busque artigos de notícias que correspondam à sua palavra-chave. Suas palavras-chave ajudam o sistema a encontrar os artigos mais relevantes para você. Você pode usar palavras juntamente com operadores lógicos, sobre os quais você pode aprender mais na seção [inserir link aqui]. Exemplos: technology"artificial intelligence"apple AND iphone |
startDate | string | — | Este parâmetro permite filtrar artigos com base na data de publicação. Você pode especificar uma data e a API retornará apenas os artigos publicados a partir dessa data. Exemplos: 2024-12-15T17:48:56Z2025-05-20 |
endDate | string | — | Este parâmetro permite filtrar artigos com base na data de publicação. Você pode especificar uma data e a API retornará apenas os artigos publicados até essa data. Exemplos: 2024-08-14T17:48:56Z2024-01-23 |
content | boolean | false | Este parâmetro permite recuperar o conteúdo completo dos artigos. Por padrão, o conteúdo é truncado. Defina-o como verdadeiro para obter o conteúdo completo. Exemplos: truefalse |
lang | string | — | Este parâmetro permite especificar o idioma dos artigos de notícias retornados pela API. Você pode combinar vários idiomas separando-os por vírgula. Veja a lista de idiomas. Exemplos: enen,fr,de |
country | string | — | Este parâmetro permite especificar o país onde os artigos de notícias retornados pela API foram publicados. Você pode combinar vários países separando-os por vírgula. Veja a lista completa de países. Exemplos: usgb,de,fr |
region | string | — | Este parâmetro permite especificar a região onde os artigos de notícias retornados pela API foram publicados. Você pode combinar várias regiões separando-as por vírgula. Veja a lista completa de regiões. Exemplos: americasafrica,asia |
category | string | — | Este parâmetro permite filtrar os artigos de notícias retornados por uma categoria específica. Você pode combinar várias categorias separando-as por vírgula. Veja a lista completa de categorias. Exemplos: financefood,health,hobbies,lifestyle |
max | integer | 5 | Este parâmetro permite especificar o número de artigos de notícias retornados pela API em uma única solicitação. Os valores válidos variam de 1 a 100, dependendo da sua assinatura. Exemplos: 1020 |
attributes | string | title,description | Este parâmetro permite selecionar em quais partes dos artigos de notícias as palavras-chave serão pesquisadas. Os valores válidos são título , descrição e conteúdo . Você pode combinar vários atributos separando-os por vírgula. Por exemplo, "título,descrição" significa pesquisar tanto no título quanto na descrição. Exemplos: titletitle,description,content |
page | integer | 1 | Este parâmetro permite controlar a paginação dos resultados retornados pela API. Cada página exibe um determinado número de artigos, definido pelo valor de "max". Exemplos: 120 |
sortby | string | publishedAt | Este parâmetro permite escolher como os artigos serão classificados. Existem duas opções: Exemplos: publishedAtrelevance |
publisher | string | — | Pesquise notícias de uma editora específica. Você pode combinar várias editoras separando-as por vírgula. Exemplos: bbc.comforbes.com,cnn.com,bbc.com |
format | string | json | Este parâmetro permite selecionar o formato de dados retornado pela API. Você pode escolher entre json, csv, or xlsx Exemplos: csvxlsx |
ai_sentiment | string | — | Filtre artigos por valor de sentimento detectado por IA Exemplos: positivenegativeneutral |
ai_entity_name | string | — | Filtrar artigos pelo nome da entidade extraída (separados por vírgula para múltiplos nomes) Exemplos: AppleMicrosoft,Google |
ai_entity_type | string | — | Filtre os artigos por tipo de entidade, como PESSOA, ORG, LOC (separados por vírgula para múltiplos). Exemplos: ORGPERSON,LOC |
Resposta
A API retorna um objeto JSON contendo uma matriz de artigos de notícias que correspondem aos seus critérios de pesquisa.
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. |