Cómo utilizar la API de The Stack

En esta guía te explicamos cómo utilizar la API de The Stack para consultar datos de forma programática, desde cómo obtener tu clave de API hasta enviar tus primeras peticiones.

1. Registro y Verificación

Para comenzar, crea una cuenta en la página de registro de The Stack.

Tras registrarte, recibirás un correo electrónico automático con un enlace de verificación. Revisa tu bandeja de entrada (y la carpeta de spam si no lo ves en un minuto).

Al pulsar en el enlace, tu cuenta quedará verificada y se activarán los créditos de prueba gratuitos, visibles en tu Panel de control:

2. Generar tu clave de API

Una vez verificado, accede a la sección de Claves de API:

1. Haz clic en “Generar Nueva Clave”.
2. Aparecerá una ventana modal segura mostrando tu nueva clave secreta de API:

Importante: Copia y guarda tu clave secreta inmediatamente en un gestor de contraseñas seguro o en tu archivo .env. Por motivos de seguridad, las claves secretas no se vuelven a mostrar tras cerrar esta ventana.

Puedes crear hasta 3 claves simultáneas para distintos entornos (por ejemplo: producción, pruebas o desarrollo local).

3. Enviar tus primeras peticiones

Cada llamada a la API de The Stack se autentica enviando tu clave secreta en la cabecera HTTP X-API-KEY.

Ejemplo A: Buscar publicaciones de Reddit

Puedes consultar publicaciones de Reddit indexadas filtrando por subreddit, búsqueda de palabras clave, puntuación y fecha de publicación:

1
2

curl -X GET "https://thestack.es/api/v1/search/reddit?subreddit=SaaS&search=revenue&sort_by=score&order=desc" \
     -H "X-API-KEY: {tu_clave_api}"

Ejemplo B: Buscar perfiles de inversores

Consulta inversores ángel, fondos de capital riesgo y perfiles verificados filtrando por ubicación y preferencias de inversión:

1
2

curl -X GET "https://thestack.es/api/v1/search/investors?page=1&sort_by=updated_at&order=desc" \
     -H "X-API-KEY: {tu_clave_api}"

Parámetros de consulta habituales

• page y per_page: Controles de paginación estándar (por defecto 15, máximo 100).
• sort_by y order: Campos de ordenación (como posted_at, score, updated_at) con orden asc o desc.
• X-API-KEY: Tu token de autenticación enviado como cabecera HTTP.

La API devuelve una respuesta en formato JSON limpio con tu conjunto de datos, metadatos de paginación y recuentos totales.

4. Documentación interactiva de la API (Swagger)

Ofrecemos documentación OpenAPI / Swagger detallada para todos los endpoints disponibles en thestack.es/api/docs/.

Puedes probar cualquier endpoint directamente desde tu navegador desplegando la operación y haciendo clic en “Try it out”:

5. Integración con herramientas No-Code y hojas de cálculo

Si no programas directamente en Python, JavaScript o cURL, puedes conectar fácilmente la API de The Stack con tus herramientas habituales:

• Hojas de cálculo: Utiliza extensiones como API Connector o funciones nativas en Google Sheets y Microsoft Excel para volcar datos en directo a tus tablas.
• Clientes de API: Importa los endpoints en Postman o Insomnia para realizar pruebas e inspeccionar respuestas.
• Automatización de procesos: Conecta tu clave de API en plataformas como Make, Zapier, Retool o Clay para crear flujos automatizados de captación y enriquecimiento de prospectos.