Personality API

DISC + OCEAN trait estimation desde texto público B2B.

⚠ Naturaleza del output: trait estimation desde texto vía LLM. NO es un test psicométrico validado (NEO-PI-R, IPIP-NEO). Las inferencias son hipótesis para asistencia comercial — NO usar para hiring/HR decisions (TOS).

Spec OpenAPI 3.1: /api-docs/openapi.yaml

Pricing: $0.05 / análisis (PAYG) · $39 / mes por 1000 análisis · 60 calls/min/key.

Quick start

1 · Generar API key

Logueate en app.ingrowthsolutions.com/admin/api-key y copiá tu key.

2 · curl

curl -X POST https://app.ingrowthsolutions.com/api/v1/personality/analyze \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "VP de Operaciones en cadena retail. 15 años en logística e inventarios. Cerramos Q1 con +28% en sell-through...",
    "leadName": "Laura Garza",
    "cargo":    "VP de Operaciones",
    "company":  "Cinépolis"
  }'

3 · Response shape

{
  "disc": {
    "primary":    "D",
    "secondary":  "C",
    "scores":     { "D": 80, "I": 30, "S": 45, "C": 65 },
    "confidence": 0.78
  },
  "big5": {
    "openness":          65,
    "conscientiousness": 80,
    "extraversion":      55,
    "agreeableness":     50,
    "neuroticism":       45
  },
  "justification": "Cargo VP + métricas duras (+28% sell-through) sugieren orientación ejecutiva con foco analítico.",
  "model":         "gemini-2.5-flash-lite",
  "analyzed_at":   "2026-05-08T01:00:00.000Z",
  "latency_ms":    1240,
  "cost_usd":      0.05
}

SDKs

Plan v1.1: SDKs Node + Python publicados como paquetes npm/pip. Mientras: cualquier lenguaje con HTTP + JSON funciona — el endpoint es estable y idempotente.

Errores típicos

Status	error code	Mitigation
401	missing_api_key \| invalid_api_key	Verificar header X-API-Key y que la key no fue revocada.
400	text_too_short	Mínimo 80 chars de texto. Concatená múltiples sources si es necesario.
429	rate_limit_exceeded	60/min/key. Backoff exponencial recomendado, retry_after_seconds en body.
502	llm_error \| safety_block	Upstream LLM caído o filtro de safety. Reintentar tras 30s.

Compliance

El motor que sirve esta API es el mismo que usa Growly internamente. Cumple privacy policy + DPIA. Para erasure (Art. 17 GDPR) de prospects: /legal/erasure-request.

Soporte: api@ingrowthsolutions.com