API pública · v1 · REST + JSON

Integra los datos de comercio exterior de Colombia en tu plataforma

Empresas importadoras y exportadoras, rankings, scoring de propensión de compra y análisis con IA sobre datos DIAN — disponibles vía HTTP desde cualquier lenguaje.

Solicitar acceso Referencia interactiva
request
curl "https://cabbie-morale-repurpose.ngrok-free.dev/v1/buscar?q=bavaria" \
     -H "X-API-Key: dmi_tu_llave"
response · 200
{
  "total": 3,
  "resultados": [
    {
      "nit": "860005224",
      "empresa": "BAVARIA & CIA SCA",
      "tipo": "importadora",
      "declaraciones": 6925,
      "fob_total": 532.76
    }
  ]
}

¿Qué puedes construir?

Scoring en tu CRM

Prioriza tu pipeline comercial con la probabilidad de compra de cada importador para tu partida arancelaria.

Verificación de contrapartes

Valida en tu onboarding si una empresa colombiana realmente importa o exporta: historial, volúmenes y orígenes.

Clasificación en tu ERP

Clasifica productos a subpartida NANDINA de 10 dígitos con IA, con costos de importación incluidos.

Quickstart

De cero a tu primer request en menos de 10 minutos.

  1. 1

    Solicita tu llave

    Escríbenos indicando tu caso de uso y el plan que necesitas. Te entregamos una llave con formato dmi_… — se muestra una sola vez.

  2. 2

    Guárdala segura

    En una variable de entorno del servidor. Nunca en el código fuente, ni en el frontend, ni en repositorios.

    export DORADO_API_KEY="dmi_tu_llave"
  3. 3

    Haz tu primer request

    Todos los endpoints reciben la llave en el header X-API-Key y responden JSON.

    curl "https://cabbie-morale-repurpose.ngrok-free.dev/v1/empresa/860005224/resumen" \
     -H "X-API-Key: $DORADO_API_KEY"
  4. 4

    Maneja los errores

    401 llave inválida · 403 llave desactivada · 422 parámetros inválidos · 429 rate limit o cuota agotada (el mensaje indica cuál). Reintenta con backoff solo en 429 y 5xx.

    import os, requests

API     = "https://cabbie-morale-repurpose.ngrok-free.dev"
HEADERS = {"X-API-Key": os.environ["DORADO_API_KEY"]}

r = requests.get(f"{API}/v1/scoring/partida/0901119000/top",
                 headers=HEADERS)
r.raise_for_status()
print(r.json())
  5. 5

    Monitorea tu consumo

    GET /v1/mi-cuenta devuelve tu plan, consumo del mes y cuotas restantes. No gasta cuota: consúltalo cuanto quieras.

    curl "https://cabbie-morale-repurpose.ngrok-free.dev/v1/mi-cuenta" \
     -H "X-API-Key: $DORADO_API_KEY"

Endpoints

Parámetros, esquemas de respuesta y pruebas en vivo en la referencia interactiva.

Consultas

  • GET /v1/buscar
  • GET /v1/empresa/{nit}/resumen
  • GET /v1/empresa/{nit}/exportaciones
  • GET /v1/empresa/{nit}/importaciones
  • GET /v1/ranking
  • GET /v1/categorias
  • GET /v1/categoria/{categoria}
  • GET /v1/partida/{partida}/segmentos
  • GET /v1/partida/{partida}/costos

Scoring

  • GET /v1/scoring/{nit}/{partida}
  • GET /v1/scoring/partida/{partida}/top
  • GET /v1/scoring/empresa/{nit}/partidas

Análisis con IA

  • POST /v1/ia/analisis/producto
  • POST /v1/ia/analisis/exportacion
  • POST /v1/ia/clasificar/partida

Tu cuenta

  • GET /v1/mi-cuenta

Planes

Cuotas mensuales — se reinician el día 1 de cada mes (UTC). Precio según volumen: cuéntanos tu caso.

Básico

  • 1.000 consultas/mes
  • 10 análisis IA/mes
  • Rate limit: 60 req/min · IA 5/min

Para probar la integración y volúmenes bajos.

Pro

  • 10.000 consultas/mes
  • 100 análisis IA/mes
  • Rate limit: 60 req/min · IA 5/min

Para integraciones en producción.

Enterprise

  • Ilimitadas consultas/mes
  • 300 análisis IA/mes
  • Rate limit: 60 req/min · IA 5/min

Volúmenes altos y acuerdos a medida.

¿Listo para integrar?

Escríbenos con tu caso de uso y te entregamos tu llave con la guía completa de integración.

hello@colombiamarketintel.comVer planes de la plataforma