DOCUMENTACIÓN
Crea con News Search API
Una API REST para buscar y leer noticias de medios de todo el mundo. JSON mediante HTTPS, respuestas con una estructura predecible y errores en inglés.
Pruébala sin clave
GET /v1/headlines/sample es público, así que puedes ver una respuesta real antes de registrarte. Pega este ejemplo en una terminal:
curl "https://apis.newssearchapi.com/v1/headlines/sample"const response = await fetch("https://apis.newssearchapi.com/v1/headlines/sample");
const data = await response.json();import os
import requests
response = requests.get(
"https://apis.newssearchapi.com/v1/headlines/sample",
)
data = response.json()req, _ := http.NewRequest(
"GET",
"https://apis.newssearchapi.com/v1/headlines/sample",
nil,
)
resp, err := http.DefaultClient.Do(req)$response = file_get_contents(
"https://apis.newssearchapi.com/v1/headlines/sample"
);
$data = json_decode($response, true);¿Todo listo para usar la API completa? Crea una clave gratuita. Free incluye 3000 búsquedas al mes y no requiere tarjeta.
Conceptos básicos
- URL base
https://apis.newssearchapi.com- Autenticación
- Cabecera
X-Api-Key: <tu clave>. Más opciones - Formato
- JSON. Las respuestas correctas incluyen
"status": "ok". - Errores
- Un
codeestable, unmessagelegible y unrequestId. Códigos (inglés) - Versiones
- La versión está en la ruta (
/v1). Los cambios incompatibles se anuncian antes en el registro de cambios (inglés). - CORS
- Habilitado para
GET; guarda las claves en tu servidor, no en código del navegador.
Empieza aquí
- Guía de inicioConsigue una clave y realiza tu primera solicitud autenticada.
- Referencia de la API (inglés)Endpoints, parámetros y campos de respuesta, con solicitudes en vivo.
- AutenticaciónOpciones para enviar y proteger tu clave.
- Servidor MCP (inglés)Conecta noticias a agentes de Claude, Cursor o VS Code.
Endpoints
La referencia detallada y sus herramientas interactivas están en inglés.
GET/v1/articlesSearch articlesGET/v1/articles/{id}Get one articleGET/v1/countsCount articles over timeGET/v1/statsCoverage statisticsPúblico · Sin clave APIGET/v1/headlines/sampleSample of latest headlinesPúblico · Sin clave APIGET/v1/publisher-icons/{domain}Get a publisher iconPúblico · Sin clave APIGET/healthHealth checkPúblico · Sin clave API
Crea con IA
- SDK de TypeScript y Python (inglés)Clientes tipados con herramientas de paginación y sondeo.
- Mantén actualizado un índice RAG (inglés)Consulta los artículos recién indexados con un cursor persistente.
- Llamadas a herramientas de LLM (inglés)Esquemas de búsqueda para OpenAI y Anthropic.
- Especificación OpenAPI 3.1Impórtala en Postman, Insomnia o un generador de clientes.
¿Necesitas ayuda?
Incluye el requestId del error o la cabecera X-Request-Id al escribir a soporte. Consulta el estado de la API (inglés) si las solicitudes empiezan a fallar.