Desarrolladores
API de datos
La API de datos de INSIGHTEX devuelve perfiles públicos de empresas con indicadores documentados, para que tus herramientas lean los mismos datos que ves en el directorio.
Los indicadores resumen señales observadas públicamente con fórmulas fijas y documentadas. No son predicciones, calificaciones ni asesoramiento de inversión.
Quién puede usarla
La API de datos y las exportaciones masivas están incluidas en los espacios de trabajo Enterprise.
Autenticación
Crea un token en tu página API de datos y envíalo en la cabecera Authorization como token Bearer, o en la cabecera X-Api-Key. Una sesión iniciada en el navegador también funciona.
Nunca pongas un token en una URL. Las solicitudes con un token en la cadena de consulta se rechazan.
Ejemplo de solicitud
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://www.insightex.si/api/v1/data/organizations?limit=50&country=US&updated_since=2026-01-01"Endpoints
GET /api/v1/data/organizations- Devuelve una página de organizaciones, en JSON o CSV.
GET /api/v1/data/organizations/export- Devuelve todas las organizaciones que coinciden en un solo archivo CSV o JSON transmitido.
Parámetros
| Parámetro | Descripción |
|---|---|
limit | Filas por página, de 1 a 100. El valor predeterminado es 50. |
cursor | El valor de meta.next_cursor de la página anterior. Omítelo en la primera página. |
country | Códigos de país de dos letras (ISO 3166-1 alfa-2) separados por comas, hasta 20. |
sector | Slugs de sector separados por comas, hasta 20. |
q | El nombre de la organización contiene este texto (de 2 a 100 caracteres, sin distinguir mayúsculas). |
updated_since | Una fecha o fecha y hora ISO 8601. Devuelve las organizaciones cuyo perfil, señales, rondas de financiación o métricas han cambiado desde entonces. |
format | json (predeterminado) o csv. |
Paginación
Los resultados se ordenan por id de organización. Sigue meta.next_cursor, o links.next, hasta que sea null. Ninguna organización aparece dos veces.
Campos de la respuesta
organization- Nombre, slug, tipo, sitio web, enlace al perfil, sectores y países.
indicators- funding_activity, team_growth, product_launch_cadence y signal_score_30d. Cada indicador tiene una puntuación, una confianza, un id de método, una justificación y sus evidencias.
preference_match- Cuánto coincide la organización con las preferencias de sector y mercado de tu propio espacio de trabajo.
updated_at- Cuándo cambió por última vez el perfil de la organización.
Métodos de los indicadores
Cada indicador usa una fórmula fija. Si no hay evidencias, su puntuación y su confianza son null en lugar de una estimación.
funding_activity.v1- Rondas de financiación fechadas anunciadas en los últimos 365 días y señales de financiación de los últimos 180 días. Puntuación = min(95, 20 + 5 × suma de puntuaciones de señales + 12 × rondas). Las rondas sin fecha nunca cuentan.
team_growth.v1- El cambio anualizado entre la primera y la última plantilla fechada. Tasa = ((última − primera) ÷ primera) × 365 ÷ días entre ambas; puntuación = 50 + 25 × tasa, limitada entre 5 y 95. Null con menos de dos cifras, una primera cifra de cero o un periodo inferior a 30 días.
product_launch_cadence.v1- Señales de lanzamiento y de nuevas versiones de los últimos 90 días. Puntuación = min(95, 20 + 14 × señales + 3 × suma de puntuaciones de señales). Null si no hay ninguna.
signal_score_30d- La suma de todas las puntuaciones de señales de los últimos 30 días.
preference_match.v1- La proporción de las preferencias de sector y país que has definido que coinciden con la organización: 0, 50 o 100. Null si no has definido ninguna.
Los indicadores resumen señales observadas públicamente con fórmulas fijas y documentadas. No son predicciones, calificaciones ni asesoramiento de inversión.
Límites de uso
120 solicitudes por minuto por miembro, uses los tokens que uses, y 10 exportaciones completas por hora. Las respuestas incluyen las cabeceras X-RateLimit-Limit y X-RateLimit-Remaining.
Errores
400: se envió un token en la URL. 401: el token falta, no es válido, ha caducado o se ha revocado. 402: el espacio de trabajo no incluye la API de datos. 403: el token no puede usar este endpoint. 422: un parámetro no es válido. 429: demasiadas solicitudes; espera el tiempo de Retry-After.
Versiones
Cada respuesta incluye la cabecera X-Insightex-Api-Version. Cuando cambia una fórmula, también cambia su id de método, por ejemplo de .v1 a .v2. El endpoint anterior /api/data-products/organizations se mantiene por compatibilidad.