Syntaxe de requête
Comprendre la syntaxe des requêtes pour rechercher efficacement des articles de presse
AllNewsAPI prend en charge une syntaxe de requête puissante qui vous permet de rechercher des articles d'actualité avec précision. Découvrez comment utiliser les opérateurs pour affiner vos recherches.
- Encodez toujours votre chaîne de requête en URL.
- Utilisez des guillemets autour des caractères spéciaux
- Combinez les opérateurs pour des résultats précis
Recherche de base
La méthode la plus simple pour effectuer une recherche consiste à fournir des mots-clés. L'API renverra les articles contenant ces mots-clés.
covid-19 ) est interprété comme un caractère littéral et non comme une négation. Pour exclure un terme, utilisez plutôt l'opérateur NOT .Recherche par expression
Utilisez les guillemets pour rechercher une expression exacte. Cela garantit que les mots apparaissent ensemble dans l'ordre spécifié.
Opérateur ET
Par défaut, les espaces entre les mots sont considérés comme des opérateurs AND . Vous pouvez également utiliser AND explicitement.
Opérateur de bloc opératoire
Utilisez l'opérateur OR pour rechercher les articles contenant l'un ou l'autre terme. Pour contrôler la priorité, regroupez les termes entre parenthèses, par exemple iphone AND (13 OR 14) .
Opérateur NON
Utilisez la NOT pour exclure les articles contenant des termes spécifiques.
Opérateurs de combinaison
Vous pouvez combiner les opérateurs pour les requêtes complexes. Utilisez des parenthèses pour contrôler la priorité.
Filtrage par IA
Les filtres d'IA tels que ai_sentiment , ai_entity_name et ai_entity_type sont des paramètres de chaîne de requête distincts, et non des opérateurs à l'intérieur q . Ajoutez-les à l'URL de la requête avec q pour affiner les résultats par sentiment, nom d'entité ou type d'entité.
Opérateurs non pris en charge
q : portée des champs ( field:value ), expressions régulières ( /.../ ), caractères génériques ( * et ? ), recherches floues et de proximité ( ~ ), boosting ( ^ ) et syntaxe de plage ( [a TO b] ).Exemples de requêtes valides
| Requête | Résultat attendu |
|---|---|
google | Articles de presse contenant le mot Google |
google OR android | Articles de presse contenant le mot Google ou le mot Android |
"google android" | Articles de presse contenant le mot google android dans le même ordre exact |
"windows 8" AND "windows 10" | Articles de presse contenant les deux mots : Windows 8 et Windows 10 |
iphone AND (13 OR 14) | Articles de presse contenant le mot iPhone et l'un des 13 ou 14 |
android NOT google | Articles de presse contenant le mot « Android » mais pas le mot « Google ». |
technology&ai_sentiment=positive | La requête q=technology combinée avec le paramètre séparé ai_sentiment=positive (ne faisant pas partie de q ) |
Apple&ai_entity_type=ORG | La requête q=Apple combinée avec le paramètre séparé ai_entity_type=ORG (ne faisant pas partie de q ) |
climate&ai_entity_name=United Nations | La requête q=climate combinée avec le paramètre séparé ai_entity_name=United Nations (ne faisant pas partie de q ) |