Sintaxis de consulta
Comprenda la sintaxis de consulta para buscar artículos de noticias de manera efectiva.
AllNewsAPI admite una potente sintaxis de consulta que permite buscar artículos de noticias con precisión. Aprenda a usar operadores para refinar sus búsquedas.
- Siempre codifique su cadena de consulta en formato URL.
- Utilice comillas alrededor de los caracteres especiales.
- Combine operadores para obtener resultados precisos.
Búsqueda básica
La forma más sencilla de buscar es proporcionar palabras clave. La API devolverá los artículos que contengan esas palabras clave.
covid-19 ) se interpreta como un carácter literal, no como una negación. Para excluir un término, utilice el operador NOT .Búsqueda de frases
Utilice comillas para buscar una frase exacta. Esto garantiza que las palabras aparezcan juntas en el orden especificado.
Y operador
Por defecto, los espacios entre palabras actúan como operadores AND . También puede usar AND explícitamente.
Operador de quirófano
Utilice OR para buscar artículos que contengan cualquiera de los dos términos. Para controlar la precedencia, agrupe los términos con paréntesis, por ejemplo iphone AND (13 OR 14) .
NO Operador
Utilice NOT para excluir artículos que contengan términos específicos.
Combinación de operadores
Puedes combinar operadores para realizar consultas complejas. Usa paréntesis para controlar la precedencia.
Filtrado de IA
Los filtros de IA, como ai_sentiment , ai_entity_name y ai_entity_type , son parámetros de cadena de consulta independientes, no operadores dentro de q . Agréguelos a la URL de la solicitud junto con q para refinar los resultados por sentimiento, nombre de entidad o tipo de entidad.
Operadores no compatibles
q : ámbito de campo ( field:value ), expresiones regulares ( /.../ ), comodines ( * y ? ), búsquedas difusas y de proximidad ( ~ ), potenciación ( ^ ) y sintaxis de rango ( [a TO b] ).Ejemplos de consultas válidas
| Consulta | Resultado esperado |
|---|---|
google | Artículos de noticias que contienen la palabra Google |
google OR android | Artículos de noticias que contienen la palabra Google o la palabra Android |
"google android" | Artículos de noticias que contienen la palabra google android en el mismo orden exacto |
"windows 8" AND "windows 10" | Artículos de noticias que contienen ambas palabras: Windows 8 y Windows 10 |
iphone AND (13 OR 14) | Artículos de noticias que contienen la palabra Iphone y uno de 13 o 14 |
android NOT google | Artículos de noticias que contienen la palabra android pero no la palabra google |
technology&ai_sentiment=positive | La consulta q=technology combinada con el parámetro separado ai_sentiment=positive (no forma parte de q ) |
Apple&ai_entity_type=ORG | La consulta q=Apple combinada con el parámetro separado ai_entity_type=ORG (no forma parte de q ) |
climate&ai_entity_name=United Nations | La consulta q=climate combinada con el parámetro separado ai_entity_name=United Nations (no forma parte de q ) |