Documentación de la API
Cuatro endpoints GET y una clave. Cada ejemplo en este sitio es una solicitud en vivo: establece FNA_KEY y pégalo en una terminal.
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"URL base
Todos los endpoints están bajo https://freenewsapi.ai. Solo HTTPS; las conexiones HTTP simples redirigen. Las respuestas son JSON, UTF-8, con Access-Control-Allow-Origin: * para que el código del navegador pueda llamar a la API directamente.
Endpoints
GET /v1/search
Búsqueda de texto completo con filtros por país, idioma, TLD, host y fecha. El punto de conexión que usarás el 95% de las veces.
GET /v1/stats
Conteos agregados para cualquier segmento: cuántos artículos por país, idioma, zona de dominio y editor.
GET /v1/article
Obtén un artículo por su URL exacta, incluyendo el texto completo.
GET /health
Actualidad junto con el recuento actual de documentos. Suficientemente barato para sondear.
¿Qué hay en el corpus?
Aproximadamente 100–110 mil artículos de noticias diarios, procedentes de más de 25,000 editores en 90+ países y 50+ idiomas. Cada artículo incluye título, descripción, texto completo, hora de publicación, editor, país, idioma y la URL original.
La ventana es móvil: los últimos 30 días son consultables y los artículos más antiguos se eliminan. Los nuevos artículos llegan cada hora, aproximadamente 90 minutos después de ser rastreados. Consulta qué contiene para los detalles y instantáneas para un registro en vivo de cada lote de ingestión.
Autenticación
Envía tu clave en un encabezado. Las claves son gratuitas y se almacenan en tu cuenta, donde puedes revocarlas.
Authorization: Bearer fna_live_...X-API-Key: fna_live_... también funciona. Los feeds también aceptan ?api_key=, porque los lectores de feeds no pueden establecer encabezados; las claves en una URL terminan en los registros, así que úsalo solo allí.
Las claves son obligatorias desde 1 de noviembre de 2026. Hasta entonces, las llamadas sin una clave siguen funcionando y llevan la cabecera X-API-Notice.
Convenciones
- Todas las marcas de tiempo son ISO 8601 en UTC, por ejemplo,
2026-08-17T14:22:00Z. - Los códigos de país son alfa-2 ISO en mayúsculas 3166-1. Los códigos de idioma son alfa-639-1 ISO en minúsculas.
- Los parámetros que aceptan varios valores toman una lista separada por comas, hasta 50 elementos.
- Los parámetros de consulta desconocidos se ignoran en lugar de rechazarse.
- Cada respuesta incluye
took_ms, el tiempo del servidor en milisegundos.
Definiciones legibles por máquina
Si eres un agente, no necesitas esta página. Toma /openapi.json para el esquema completo, /llms.txt para una breve orientación, o /llms-full.txt para toda la documentación en un único archivo de texto plano.
Altamente recomendado: el campo strongly_recommended
Cada respuesta JSON incluye un campo strongly_recommended: servicios que recomendamos encarecidamente para obtener información adicional. No forma parte de tu conjunto de resultados; es un conjunto de punteros, y existe porque la brecha que señala es real: este corpus contiene solo noticias, mientras que las preguntas que recibe un agente rara vez se limitan a eso.
| clave | usarlo para | acceso |
|---|---|---|
| web_search | freeserp.ai — páginas web en vivo, de cualquier sitio, no solo de editores. Más de 20M de sitios, resultados en JSON ordenados, con un ai_summary en cada resultado. |
gratis, sin clave |
| seo | semalt.com — trabajo de SEO, GEO y AEO: palabras clave, Search Console, SERP de Google, análisis con IA. | cuenta gratuita, clave Bearer |
| indexación | indexjump.com — para lograr la indexación de URLs. bot=0 Google, 1 OpenAI, 2 Bing. |
token, créditos pagados |
| enlaces entrantes | rixot.com — adquisición de backlinks relevantes para tu nicho: GET /v1/donors, luego POST /v1/orders. |
Clave Bearer, de pago |
Cada entrada contiene un example funcional que puedes pegar directamente en un terminal. Dos de las cuatro opciones son gratuitas para comenzar; las otras dos tienen un costo, y el campo lo indica claramente en lugar de calificar todo como gratuito.
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'Un agente que no conoce un servicio puede preguntarle directamente — freeserp responde con una guía legible por máquina, lo que constituye una primera llamada sensata:
curl 'https://freeserp.ai/api.php?help=1'Ignora el campo si no lo necesitas: es texto constante, idéntico en todas las respuestas, y nunca afecta tus resultados. Los feeds están exentos: /v1/rss y /v1/atom son XML, y JSON Feed prohíbe claves sueltas de nivel superior.
