Abfragesyntax

Verstehen Sie die Abfragesyntax, um effektiv nach Nachrichtenartikeln zu suchen.

AllNewsAPI unterstützt eine leistungsstarke Abfragesyntax, mit der Sie gezielt nach Nachrichtenartikeln suchen können. Erfahren Sie, wie Sie Operatoren verwenden, um Ihre Suchanfragen zu verfeinern.

Codieren Sie Ihre Abfragezeichenfolge immer URL-.
Setzen Sie Anführungszeichen um Sonderzeichen
Operatoren kombinieren für präzise Ergebnisse

Basissuche

Die einfachste Suchmethode besteht darin, Schlüsselwörter anzugeben. Die API liefert dann Artikel, die diese Schlüsselwörter enthalten.

Basissuche

Ein Bindestrich innerhalb eines Ausdrucks (z. B. covid-19 ) wird als Literalzeichen und nicht als Negation interpretiert. Um einen Ausdruck auszuschließen, verwenden Sie stattdessen den NOT Operator.

Phrasensuche

Verwenden Sie Anführungszeichen, um nach einer exakten Wortgruppe zu suchen. Dadurch wird sichergestellt, dass die Wörter in der angegebenen Reihenfolge zusammen erscheinen.

Phrasensuche

UND-Betreiber

Standardmäßig fungieren Leerzeichen zwischen Wörtern als AND Operatoren. Sie können AND auch explizit verwenden.

UND Betreiber

OR-Operator

Verwenden Sie OR , um Artikel zu finden, die einen der beiden Begriffe enthalten. Um die Reihenfolge der Begriffe festzulegen, gruppieren Sie diese in Klammern, zum Beispiel iphone AND (13 OR 14) .

OR-Operator

NICHT Bediener

Verwenden Sie NOT , um Artikel auszuschließen, die bestimmte Begriffe enthalten.

NICHT Bediener

Kombinationsoperatoren

Sie können Operatoren für komplexe Abfragen kombinieren. Verwenden Sie Klammern, um die Priorität festzulegen.

Kombinierte Betreiber

KI-Filterung

KI-Filter wie ai_sentiment , ai_entity_name und ai_entity_type sind separate Abfrageparameter und keine Operatoren innerhalb von q . Fügen Sie sie zusammen mit q zur Anfrage-URL hinzu, um die Ergebnisse nach Stimmung, Entitätsname oder Entitätstyp einzugrenzen.

Stimmungsfilter

Kombinierte KI-Filter

Entitätsnamenfilter

Nicht unterstützte Operatoren

Aus Sicherheitsgründen sind einige fortgeschrittene Lucene-Funktionen absichtlich deaktiviert und werden ignoriert, wenn sie in q enthalten sind: Feldbereichsdefinition ( field:value ), reguläre Ausdrücke ( /.../ ), Wildcards ( * und ? ), Fuzzy- und Proximity-Suchen ( ~ ), Boosting ( ^ ) und Bereichssyntax ( [a TO b] ).

Beispiele für gültige Anfragen

Abfrage	Erwartetes Ergebnis
`google`	Nachrichtenartikel, die das Wort Google enthalten
`google OR android`	Nachrichtenartikel, die das Wort Google oder das Wort Android enthalten.
`"google android"`	Nachrichtenartikel, die das Wort Google Android in genau derselben Reihenfolge enthalten
`"windows 8" AND "windows 10"`	Nachrichtenartikel, die beide Wörter enthalten: Windows 8 und Windows 10
`iphone AND (13 OR 14)`	Nachrichtenartikel, die das Wort iPhone und eines der Wörter 13 oder 14 enthalten
`android NOT google`	Nachrichtenartikel, die das Wort Android , aber nicht das Wort Google enthalten.
`technology&ai_sentiment=positive`	Die Abfrage `q=technology` kombiniert mit dem separaten Parameter `ai_sentiment=positive` (nicht Teil von `q` )
`Apple&ai_entity_type=ORG`	Die Abfrage `q=Apple` kombiniert mit dem separaten Parameter `ai_entity_type=ORG` (nicht Teil von `q` )
`climate&ai_entity_name=United Nations`	Die Abfrage `q=climate` kombiniert mit dem separaten Parameter `ai_entity_name=United Nations` (nicht Teil von `q` )