Desenvolvedores
API de dados
A API de dados da INSIGHTEX retorna perfis públicos de empresas com indicadores documentados, para que as suas ferramentas leiam os mesmos dados que você vê no diretório.
Os indicadores resumem sinais observados publicamente com fórmulas fixas e documentadas. Não são previsões, classificações nem recomendações de investimento.
Quem pode usar
A API de dados e as exportações em massa estão incluídas nos espaços de trabalho Enterprise.
Autenticação
Crie um token na sua página API de dados e envie-o no cabeçalho Authorization como token Bearer, ou no cabeçalho X-Api-Key. Uma sessão conectada no navegador também funciona.
Nunca coloque um token em uma URL. Solicitações com um token na query string são recusadas.
Exemplo de solicitação
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- Retorna uma página de organizações, em JSON ou CSV.
GET /api/v1/data/organizations/export- Retorna todas as organizações correspondentes em um único arquivo CSV ou JSON transmitido.
Parâmetros
| Parâmetro | Descrição |
|---|---|
limit | Linhas por página, de 1 a 100. O padrão é 50. |
cursor | O valor de meta.next_cursor da página anterior. Omita na primeira página. |
country | Códigos de país de duas letras (ISO 3166-1 alfa-2) separados por vírgulas, até 20. |
sector | Slugs de setor separados por vírgulas, até 20. |
q | O nome da organização contém este texto (de 2 a 100 caracteres, sem diferenciar maiúsculas). |
updated_since | Uma data ou data e hora ISO 8601. Retorna organizações cujo perfil, sinais, rodadas de investimento ou métricas mudaram desde então. |
format | json (padrão) ou csv. |
Paginação
Os resultados são ordenados pelo id da organização. Siga meta.next_cursor, ou links.next, até que seja null. Nenhuma organização aparece duas vezes.
Campos da resposta
organization- Nome, slug, tipo, site, link do perfil, setores e países.
indicators- funding_activity, team_growth, product_launch_cadence e signal_score_30d. Cada indicador tem uma pontuação, uma confiança, um id de método, uma justificativa e suas evidências.
preference_match- Quanto a organização coincide com as preferências de setor e mercado do seu próprio espaço de trabalho.
updated_at- Quando o perfil da organização mudou pela última vez.
Métodos dos indicadores
Cada indicador usa uma fórmula fixa. Sem evidências, a pontuação e a confiança são null em vez de uma estimativa.
funding_activity.v1- Rodadas de investimento datadas anunciadas nos últimos 365 dias e sinais de investimento dos últimos 180 dias. Pontuação = min(95, 20 + 5 × soma das pontuações de sinais + 12 × rodadas). Rodadas sem data nunca contam.
team_growth.v1- A variação anualizada entre o primeiro e o último número de funcionários datado. Taxa = ((último − primeiro) ÷ primeiro) × 365 ÷ dias entre eles; pontuação = 50 + 25 × taxa, limitada entre 5 e 95. Null com menos de dois valores, um primeiro valor igual a zero ou um período inferior a 30 dias.
product_launch_cadence.v1- Sinais de lançamento e de novas versões dos últimos 90 dias. Pontuação = min(95, 20 + 14 × sinais + 3 × soma das pontuações de sinais). Null quando não há nenhum.
signal_score_30d- A soma de todas as pontuações de sinais dos últimos 30 dias.
preference_match.v1- A parcela das preferências de setor e país que você definiu que correspondem à organização: 0, 50 ou 100. Null quando você não definiu nenhuma.
Os indicadores resumem sinais observados publicamente com fórmulas fixas e documentadas. Não são previsões, classificações nem recomendações de investimento.
Limites de uso
120 solicitações por minuto por membro, independentemente de quantos tokens você use, e 10 exportações completas por hora. As respostas trazem os cabeçalhos X-RateLimit-Limit e X-RateLimit-Remaining.
Erros
400: um token foi enviado na URL. 401: o token está ausente, é inválido, expirou ou foi revogado. 402: o espaço de trabalho não inclui a API de dados. 403: o token não pode usar este endpoint. 422: um parâmetro é inválido. 429: solicitações demais; aguarde o tempo de Retry-After.
Versionamento
Toda resposta traz o cabeçalho X-Insightex-Api-Version. Quando uma fórmula muda, o id do método também muda, por exemplo de .v1 para .v2. O endpoint antigo /api/data-products/organizations é mantido por compatibilidade.