Sintassi della query
Comprendere la sintassi delle query per cercare articoli di notizie in modo efficace
AllNewsAPI supporta una potente sintassi di query che consente di cercare articoli di notizie con precisione. Scopri come utilizzare gli operatori per affinare le tue ricerche.
- Codifica sempre in URL la stringa di query.
- Utilizzare le virgolette attorno ai caratteri speciali
- Combinare gli operatori per risultati precisi
Ricerca di base
Il modo più semplice per effettuare una ricerca è fornire delle parole chiave. L'API restituirà gli articoli che contengono tali parole chiave.
covid-19 ) viene trattato come un carattere letterale, non come una negazione. Per escludere un termine, utilizzare invece l'operatore NOT .Ricerca di frasi
Utilizza le virgolette per cercare una frase esatta. In questo modo, le parole appariranno insieme nell'ordine specificato.
E Operatore
Per impostazione predefinita, gli spazi tra le parole fungono da operatori AND . È anche possibile utilizzare AND esplicitamente.
Operatore di sala operatoria
Utilizza l' OR per trovare articoli che contengono uno dei due termini. Per controllare la precedenza, raggruppa i termini tra parentesi, ad esempio iphone AND (13 OR 14) .
operatore NOT
Utilizzare NOT per escludere articoli contenenti termini specifici.
Combinazione di operatori
È possibile combinare gli operatori per query complesse. Utilizzare le parentesi per controllare la precedenza.
Filtraggio tramite IA
I filtri AI come ai_sentiment , ai_entity_name e ai_entity_type sono parametri separati della stringa di query, non operatori all'interno q . Aggiungili all'URL della richiesta insieme a q per restringere i risultati in base al sentiment, al nome dell'entità o al tipo di entità.
Operatori non supportati
q : ambito dei campi ( field:value ), espressioni regolari ( /.../ ), caratteri jolly ( * e ? ), ricerche fuzzy e di prossimità ( ~ ), boosting ( ^ ) e sintassi di intervallo ( [a TO b] ).Esempi di query valide
| Query | Risultato atteso |
|---|---|
google | Articoli di notizie che contengono la parola Google |
google OR android | Articoli di notizie che contengono la parola Google o la parola Android |
"google android" | Articoli di notizie che contengono la parola Google Android nello stesso identico ordine |
"windows 8" AND "windows 10" | Articoli di notizie che contengono entrambe le parole: Windows 8 e Windows 10 |
iphone AND (13 OR 14) | Articoli di notizie che contengono la parola iPhone e uno dei 13 o 14 |
android NOT google | Articoli di notizie che contengono la parola Android ma non la parola Google |
technology&ai_sentiment=positive | La query q=technology combinata con il parametro separato ai_sentiment=positive (non parte di q ) |
Apple&ai_entity_type=ORG | La query q=Apple combinata con il parametro separato ai_entity_type=ORG (non parte di q ) |
climate&ai_entity_name=United Nations | La query q=climate combinata con il parametro separato ai_entity_name=United Nations (non parte di q ) |