Sintaxe de consulta
Compreenda a sintaxe de consulta para pesquisar artigos de notícias de forma eficaz.
A AllNewsAPI oferece uma sintaxe de consulta poderosa que permite pesquisar artigos de notícias com precisão. Aprenda a usar operadores para refinar suas buscas.
- Sempre codifique a string de consulta em formato URL.
- Use aspas em torno de caracteres especiais.
- Combine operadores para obter resultados precisos.
Pesquisa básica
A maneira mais simples de pesquisar é fornecer palavras-chave. A API retornará artigos que contenham essas palavras-chave.
covid-19 ) é tratado como um caractere literal, não como negação. Para excluir um termo, use o operador NOT .Pesquisa por frase
Use aspas para pesquisar uma frase exata. Isso garante que as palavras apareçam juntas na ordem especificada.
E Operador
Por padrão, os espaços entre as palavras funcionam como operadores AND . Você também pode usar AND explicitamente.
Operador de sala de cirurgia
Use OR para corresponder a artigos que contenham qualquer um dos termos. Para controlar a precedência, agrupe os termos com parênteses, por exemplo iphone AND (13 OR 14) .
NÃO é o operador
Use NOT para excluir artigos que contenham termos específicos.
Combinando Operadores
Você pode combinar operadores para consultas complexas. Use parênteses para controlar a precedência.
Filtragem por IA
Os filtros de IA, como ai_sentiment , ai_entity_name e ai_entity_type , são parâmetros de consulta separados, não operadores dentro de q . Adicione-os à URL da solicitação junto com q para refinar os resultados por sentimento, nome da entidade ou tipo de entidade.
Operadoras não suportadas
q : escopo de campo ( field:value ), expressões regulares ( /.../ ), curingas ( * e ? ), buscas difusas e de proximidade ( ~ ), reforço ( ^ ) e sintaxe de intervalo ( [a TO b] ).Exemplos de consultas válidas
| Consulta | Resultado esperado |
|---|---|
google | Artigos de notícias que contêm a palavra Google |
google OR android | Notícias que contenham a palavra Google ou a palavra Android. |
"google android" | Notícias que contêm a palavra "google android" exatamente na mesma ordem. |
"windows 8" AND "windows 10" | Artigos de notícias que contêm ambas as palavras: Windows 8 e Windows 10 |
iphone AND (13 OR 14) | Notícias que contêm a palavra Iphone e um dos números 13 ou 14. |
android NOT google | Notícias que contêm a palavra "android" , mas não a palavra "google". |
technology&ai_sentiment=positive | A consulta q=technology combinada com o parâmetro separado ai_sentiment=positive (não faz parte de q ) |
Apple&ai_entity_type=ORG | A consulta q=Apple combinada com o parâmetro separado ai_entity_type=ORG (não faz parte de q ) |
climate&ai_entity_name=United Nations | A consulta q=climate combinada com o parâmetro separado ai_entity_name=United Nations (não faz parte de q ) |