Point de terminaison de recherche
Recherchez des articles d'actualité à l'aide de mots clés, de filtres et d'une syntaxe de requête avancée.
Le point d'accès Recherche vous permet de rechercher des articles d'actualité dans l'ensemble de notre base de données à l'aide de mots clés, d'expressions et d'opérateurs de requête avancés. Filtrez les résultats par langue, pays, catégorie, période et plus encore.
https://api.allnewsapi.com/searchParamètres de requête
Nom | Taper | Valeur par défaut | Description |
|---|---|---|---|
apikeyRequis | string | — | Votre clé API pour l'authentification. Récupérez votre clé API depuis le tableau de bord. |
q | string | — | Ce paramètre vous permet de récupérer des articles d'actualité correspondant à votre mot-clé. Vos mots-clés aident le système à trouver les articles les plus pertinents. Vous pouvez utiliser des mots avec des opérateurs logiques ; vous trouverez plus d'informations à ce sujet dans la documentation. Exemples : technology"artificial intelligence"apple AND iphone |
startDate | string | — | Ce paramètre vous permet de filtrer les articles en fonction de leur date de publication. Vous pouvez spécifier une date, et l'API ne renverra que les articles publiés à partir de cette date. Exemples : 2024-12-15T17:48:56Z2025-05-20 |
endDate | string | — | Ce paramètre vous permet de filtrer les articles en fonction de leur date de publication. Vous pouvez spécifier une date, et l'API ne renverra que les articles publiés à cette date ou avant. Exemples : 2024-08-14T17:48:56Z2024-01-23 |
content | boolean | false | Ce paramètre vous permet de récupérer le contenu intégral des articles. Par défaut, le contenu est tronqué. Définissez cette valeur sur « true » pour obtenir le contenu complet. Exemples : truefalse |
lang | string | — | Ce paramètre vous permet de spécifier la langue des articles d'actualité renvoyés par l'API. Vous pouvez combiner plusieurs langues en les séparant par une virgule. Consultez la liste des langues disponibles. Exemples : enen,fr,de |
country | string | — | Ce paramètre vous permet de spécifier le pays de publication des articles renvoyés par l'API. Vous pouvez indiquer plusieurs pays en les séparant par une virgule. Consultez la liste complète. Exemples : usgb,de,fr |
region | string | — | Ce paramètre vous permet de spécifier la région de publication des articles renvoyés par l'API. Vous pouvez combiner plusieurs régions en les séparant par une virgule. Consultez la liste complète. Exemples : americasafrica,asia |
category | string | — | Ce paramètre vous permet de filtrer les articles d'actualité affichés par catégorie. Vous pouvez combiner plusieurs catégories en les séparant par une virgule. Voir la liste complète. Exemples : financefood,health,hobbies,lifestyle |
max | integer | 5 | Ce paramètre vous permet de spécifier le nombre d'articles d'actualité renvoyés par l'API en une seule requête. Les valeurs valides sont comprises entre 1 et 100, selon votre abonnement. Exemples : 1020 |
attributes | string | title,description | Ce paramètre vous permet de sélectionner les parties des articles dans lesquelles les mots clés doivent être recherchés. Les valeurs possibles sont : titre , description et contenu . Vous pouvez combiner plusieurs attributs en les séparant par une virgule. Par exemple, « titre,description » signifie que la recherche s’effectuera à la fois dans le titre et la description. Exemples : titletitle,description,content |
page | integer | 1 | Ce paramètre permet de contrôler la pagination des résultats renvoyés par l'API. Chaque page affiche un certain nombre d'articles, déterminé par la valeur de « max ». Exemples : 120 |
sortby | string | publishedAt | Ce paramètre vous permet de choisir le mode de tri des articles. Deux options sont disponibles : Exemples : publishedAtrelevance |
publisher | string | — | Recherchez les actualités d'un éditeur spécifique. Vous pouvez combiner plusieurs éditeurs en les séparant par une virgule. Exemples : bbc.comforbes.com,cnn.com,bbc.com |
format | string | json | Ce paramètre vous permet de sélectionner le format des données renvoyées par l'API. Vous pouvez choisir parmi les options suivantes : json, csv, or xlsx Exemples : csvxlsx |
ai_sentiment | string | — | Filtrer les articles selon la valeur de sentiment détectée par l'IA Exemples : positivenegativeneutral |
ai_entity_name | string | — | Filtrer les articles par nom d'entité extrait (séparés par des virgules pour les noms multiples) Exemples : AppleMicrosoft,Google |
ai_entity_type | string | — | Filtrer les articles par type d'entité, par exemple PERSONNE, ORG, LOC (séparés par des virgules pour plusieurs types). Exemples : ORGPERSON,LOC |
Réponse
L'API renvoie un objet JSON contenant un tableau d'articles de presse correspondant à vos critères de recherche.
Nom | Taper | Valeur par défaut | Description |
|---|---|---|---|
totalArticles | integer | — | Le nombre total d'articles correspondant à votre requête de recherche |
currentPage | integer | — | Le numéro de page actuel dans les résultats paginés |
nextPage | integer | — | Numéro de la page suivante (null si c'est la dernière page) |
articles | array | — | Un tableau d'objets d'article correspondant à vos critères de recherche |
articles[].title | string | — | Le titre de l'article de presse |
articles[].description | string | — | Description ou résumé de l'article de presse |
articles[].category | string | — | La catégorie à laquelle appartient l'article |
articles[].content | string | — | Le contenu intégral de l'article (fonctionnalité premium) |
articles[].country | string | — | Code pays du pays où l'article a été publié (ISO 3166-1 alpha-2) |
articles[].region | string | — | La région géographique où l'article a été publié |
articles[].lang | string | — | Code de langue de l'article (ISO 639-1) |
articles[].authors | array | — | Tableau des noms des auteurs d'articles |
articles[].ai_sentiment | string | — | Étiquette de sentiment détectée par l'IA (positive, négative ou neutre). Réservé aux abonnements payants. |
articles[].ai_sentiment_scores | object | — | Objet contenant les scores de confiance pour chaque catégorie de sentiment. Réservé aux abonnements payants. |
articles[].ai_entities | array | — | Tableau d'entités nommées extraites, avec les champs nom et type. Réservé aux abonnements payants. |
articles[].ai_summary | string | — | Résumé du contenu de l'article généré par IA. Réservé aux abonnements payants. |
articles[].url | string | — | L'URL directe vers l'article original |
articles[].image | string | — | L'URL de l'image principale ou de la miniature de l'article |
articles[].publishedAt | string | — | Date et heure de publication de l'article au format ISO 8601 (UTC) |
articles[].source.name | string | — | Le nom de l'éditeur ou de la source d'information |
articles[].source.url | string | — | L'URL de la page d'accueil de la source d'information |