AUTENTICACIÓN

Autentica tus solicitudes

Todas las solicitudes, salvo las dirigidas a endpoints públicos, necesitan una clave API. Las claves empiezan por gna_live_ y pertenecen al plan de tu cuenta.

Envía tu clave

Utiliza uno de estos tres métodos. Si una solicitud incluye más de uno, la API los usa en este orden.

1. Cabecera X-Api-Key (recomendada)

curl "https://apis.newssearchapi.com/v1/articles?q=climate" \
  -H "X-Api-Key: $NEWSSEARCHAPI_API_KEY"

2. Cabecera Authorization

Útil si tu cliente HTTP o pasarela ya envía tokens bearer.

curl "https://apis.newssearchapi.com/v1/articles?q=climate" \
  -H "Authorization: Bearer $NEWSSEARCHAPI_API_KEY"

3. Parámetro de consulta apiKey

Es práctico para una prueba rápida en el navegador. La clave se elimina de nuestros registros de solicitudes, pero puede quedar en el historial del navegador, proxies o herramientas de análisis; utiliza una cabecera en producción.

https://apis.newssearchapi.com/v1/articles?q=climate&apiKey=YOUR_API_KEY

Endpoints públicos

GET /v1/stats y GET /v1/headlines/sample no requieren clave, por lo que puedes evaluar los datos antes de registrarte. El endpoint de muestra permite 30 solicitudes por minuto por dirección IP. Las referencias están en inglés.

Gestiona tus claves

• Crea claves en la consola. La clave completa solo se muestra una vez; cópiala de inmediato en tu gestor de secretos. Solo guardamos un hash SHA-256.
• Usa una clave por aplicación o entorno (por ejemplo, producción y pruebas). Tu plan define cuántas claves puedes tener; los registros muestran qué clave hizo cada llamada.
• Rota una clave para emitir un nuevo secreto y retirar el anterior, por ejemplo cuando una persona deja el equipo.
• Revoca inmediatamente una clave si se filtra. Las solicitudes con ella fallarán con apiKeyRevoked.

Mantén las claves en secreto

• Guárdalas en variables de entorno o en un gestor de secretos, nunca en el código fuente ni en Git.
• No llames a la API con tu clave desde el navegador o código móvil: cualquiera podría leerla. Usa tu backend o una función sin servidor.
• Para agentes de IA, proporciona la clave al ejecutor de herramientas o a la configuración del cliente MCP (inglés), no al prompt.

Errores de autenticación