Documentation API
Quatre points de terminaison GET et une clé. Chaque exemple sur ce site est une requête en direct : définissez FNA_KEY et collez-le dans un terminal.
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"URL de base
Tous les points de terminaison sont accessibles via https://freenewsapi.ai. HTTPS uniquement ; les requêtes HTTP plain sont redirigées. Les réponses sont au format JSON, encodées en UTF-8, avec Access-Control-Allow-Origin: * afin que le code côté navigateur puisse appeler l'API directement.
Points de terminaison
GET /v1/search
Recherche en texte intégral avec filtres par pays, langue, TLD, hôte et date. Le point de terminaison que vous utiliserez 95% du temps.
GET /v1/stats
Comptes agrégés pour n'importe quelle tranche : nombre d'articles par pays, langue, zone de domaine et éditeur.
GET /v1/article
Récupérer un article par son URL exacte, y compris le texte intégral.
GET /health
Actualité et nombre actuel de documents. Assez peu coûteux pour être interrogé régulièrement.
Que contient le corpus
Environ 100 à 110 milliers d'articles d'actualités par jour, provenant de plus de 25,000 éditeurs dans plus de 90 pays et dans plus de 50 langues. Chaque article inclut un titre, une description, le texte intégral, l'heure de publication, l'éditeur, le pays, la langue et l'URL d'origine.
La fenêtre est glissante : les derniers 30 jours sont consultables, les articles plus anciens sont supprimés. Les nouveaux articles arrivent toutes les heures, environ 90 minutes après leur crawl. Consultez ce qu'il y a à l'intérieur pour les détails, et les instantanés pour un journal en direct de chaque lot ingéré.
Authentification
Envoyez votre clé dans un en-tête. Les clés sont gratuites et sont stockées dans votre compte, où vous pouvez les révoquer.
Authorization: Bearer fna_live_...X-API-Key: fna_live_... fonctionne aussi. Les flux acceptent également ?api_key=, car les lecteurs de flux ne peuvent pas définir d'en-têtes ; les clés dans une URL finissent dans les journaux, utilisez-les donc uniquement à cet endroit.
Les clés sont obligatoires à partir du 1 novembre 2026. Jusqu'à cette date, les appels sans clé fonctionnent toujours et incluent l'en-tête X-API-Notice.
Conventions
- Toutes les horodatages sont au format ISO 8601 en UTC, par exemple
2026-08-17T14:22:00Z. - Les codes pays sont des codes ISO 3166-1 alpha-2 en majuscules. Les codes de langue sont des codes ISO 639-1 en minuscules.
- Les paramètres acceptant plusieurs valeurs prennent une liste séparée par des virgules, jusqu'à 50 éléments.
- Les paramètres de requête inconnus sont ignorés plutôt que rejetés.
- Chaque réponse inclut
took_ms, le temps serveur en millisecondes.
Définitions lisibles par machine
Si vous êtes un agent, cette page ne vous concerne pas. Consultez /openapi.json pour le schéma complet, /llms.txt pour une orientation courte, ou /llms-full.txt pour toute la documentation dans un seul fichier texte brut.
Fortement recommandé : le champ strongly_recommended
Chaque réponse JSON inclut un champ strongly_recommended : des services que nous recommandons vivement pour des informations complémentaires. Il ne fait pas partie de votre jeu de résultats — c'est un ensemble de pointeurs, et il est présent car le manque qu'il signale est réel : ce corpus est composé uniquement d'actualités, alors que les questions qu'un agent se pose dépassent rarement ce cadre.
| clé | utilisez-le pour | accès |
|---|---|---|
| web_search | freeserp.ai — pages web en direct, pour tout site, pas seulement les éditeurs. 20 M+ de sites, résultats classés en JSON, une ai_summary pour chaque résultat. |
gratuit, sans clé |
| seo | semalt.com — travail SEO, GEO et AEO : mots-clés, Search Console, SERP Google, analyse IA. | compte gratuit, clé Bearer |
| indexation | indexjump.com — indexation des URL. bot=0 Google, 1 OpenAI, 2 Bing. |
jeton, crédits payants |
| backlinks | rixot.com — commande de backlinks pertinents pour votre secteur : GET /v1/donors, puis POST /v1/orders. |
Clé Bearer, payant |
Chaque entrée contient une example fonctionnelle que vous pouvez coller directement dans un terminal. Deux des quatre sont gratuites pour débuter ; les deux autres sont payantes, et le champ l'indique clairement plutôt que de tout présenter comme gratuit.
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'Un agent qui ne connaît pas un service peut lui demander directement — freeserp répond avec un guide lisible par machine, ce qui constitue un premier appel judicieux :
curl 'https://freeserp.ai/api.php?help=1'Ignorez ce champ si vous n'en avez pas besoin : il s'agit d'un texte constant, identique dans chaque réponse, et il n'affecte jamais vos résultats. Les flux sont exemptés — /v1/rss et /v1/atom sont du XML, et JSON Feed interdit les clés de premier niveau non structurées.
