Titres Endpoint

Recevez les principaux titres et les dernières nouvelles du monde entier

Le point d'accès « Titres » renvoie les principaux titres et les articles d'actualité les plus récents. Ces titres sont sélectionnés parmi les principales sources d'information et mis à jour en temps réel.

GEThttps://api.allnewsapi.com/headlines

Paramètres de requête

Nom	Taper	Valeur par défaut	Description
`apikey`Requis	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. section syntaxe des requêtes 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. langues prises en charge 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. pays et leurs codes 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. régions 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. catégories prises en charge 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 ». Par exemple, si « max » est défini sur 10, la première page affichera les articles 1 à 10, la deuxième page affichera les articles 11 à 20, et ainsi de suite. Exemples : `120`
`sortby`	string	`publishedAt`	Ce paramètre vous permet de choisir le mode de tri des articles. Deux options sont disponibles : publishedAt : Ce critère trie les articles par date de publication, les plus récents apparaissant en premier. Pertinence : Ce critère trie les articles en fonction de leur correspondance avec vos mots-clés, les articles les plus pertinents étant affichés en premier. 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 des principaux articles à la une.

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

Exemple de réponse

Réponse

Paramètres de requête

Réponse

Exemple de réponse

Exemple de requête

En rapport