Referencia API

La API de DataMerge

Una API REST para el enriquecimiento de datos B2B. Enriquece empresas por dominio, encuentra contactos por cargo y ubicación, navega jerarquías corporativas y descubre empresas similares. JSON de entrada, JSON de salida.

Abrir documentación API

Swagger UI, OpenAPI YAML. Get API key.

Base URL

api.datamerge.ai

Format

JSON / REST

Auth

API key

Processing

Async (job + poll)

Autenticación

Todas las solicitudes requieren una clave API. Obtén la tuya en app.datamerge.ai. Regístrate para obtener 20 créditos gratuitos, sin tarjeta de crédito requerida.

Cabecera de solicitud

Authorization: Token YOUR_API_KEY

or alternatively: X-API-Key: YOUR_API_KEY

Operaciones principales

Enriquecimiento de empresa

POST /v1/company/enrich

Convierte cualquier dominio en un perfil firmográfico completo: razón social registrada, dirección, industria, número de empleados, ingresos, perfiles sociales y empresa matriz global.

curl -X POST https://api.datamerge.ai/v1/company/enrich \
  -H "Authorization: Token $KEY" \
  -H "Content-Type: application/json" \
  -d '{"domains": ["stripe.com"]}'
# → {"job_id": "abc123", "status": "queued"}

1 crédito por registro exitoso · 0 si no se encuentra

Jerarquía corporativa

GET /v1/company/hierarchy

Navega el árbol corporativo completo de cualquier empresa: entidades matrices, subsidiarias y la empresa matriz global, cada una con su propia razón social y país.

curl "https://api.datamerge.ai/v1/company/hierarchy\
?datamerge_id=DM001283124635&include_names=true" \
  -H "Authorization: Token $KEY"
# → {parents: [...], company: {...}, children: [...]}

Devuelve todas las entidades del grupo · Capacidad única (pocos proveedores ofrecen esto)

Búsqueda de contactos

POST /v1/contact/search

Encuentra tomadores de decisiones en empresas por cargo, nivel de seniority y ubicación. Enriquece con direcciones de correo electrónico validadas y números de teléfono móvil.

curl -X POST https://api.datamerge.ai/v1/contact/search \
  -H "Authorization: Token $KEY" \
  -d '{
    "domains": ["stripe.com"],
    "filters": {"job_titles_include": ["CEO","CTO"]},
    "enrich_fields": ["contact.emails"]
  }'

1 crédito por correo electrónico · 4 créditos por móvil

Descubrimiento de empresas similares

POST /v1/company/lookalike

Encuentra empresas similares a una empresa de referencia, filtradas por país, industria, número de empleados e ingresos. Ideal para construir listas de prospectos a partir de tus mejores clientes.

curl -X POST https://api.datamerge.ai/v1/company/lookalike \
  -H "Authorization: Token $KEY" \
  -d '{
    "companiesFilters": {
      "lookalikeDomains": ["stripe.com"],
      "primaryLocations": ["US"],
      "companySizes": ["51-200"]
    }
  }'

1 crédito por empresa devuelta

Cómo funciona la API: Jobs asíncronos

Todos los endpoints de enriquecimiento son asíncronos. Cada solicitud devuelve inmediatamente un job_id. Consulta el endpoint de estado hasta que el job se complete. Los resultados están incluidos en la respuesta de estado.

El patrón: siempre el mismo

# Step 1: Start the job
curl -X POST https://api.datamerge.ai/v1/company/enrich \
  -H "Authorization: Token $KEY" \
  -d '{"domains": ["shopify.com"]}'

# → {"job_id": "abc123", "status": "queued"}

# Step 2: Poll until status = "completed"
curl https://api.datamerge.ai/v1/company/enrich/abc123/status \
  -H "Authorization: Token $KEY"

# → {
#     "status": "completed",
#     "record_ids": ["uuid..."],
#     "companies": [{ "legal_name": "Shopify Inc", ... }]
#   }

Estados del job: queued → processing → completed o failed. Los créditos solo se cobran en completed con resultados.

Usar DataMerge en agentes de IA

🔌

MCP Server

Conecta Claude Desktop, Cursor o Windsurf directamente. Sin código requerido. Tu agente llama a DataMerge como una herramienta nativa.

https://mcp.datamerge.ai Guía de configuración →

📄

SKILL.md

Añade el SKILL.md al contexto de tu agente. Contiene todo lo que una IA necesita para entender y llamar correctamente a la API DataMerge.

datamerge.ai/SKILL.md Ver SKILL.md →

📚

Full Docs

Una URL, toda la documentación en línea. Diseñado para agentes de IA que no pueden seguir enlaces. Obtén todo de una sola vez.

datamerge.ai/docs/llms.txt Abrir documentación →

Recursos

Interactive Docs (Redoc)

Explora todos los endpoints con ejemplos en vivo

Swagger UI

Prueba llamadas API directamente en el navegador

OpenAPI Schema (YAML)

Especificación completa OpenAPI 3.0 para generación de código

Quick Start Guide

Tu primer enriquecimiento en 5 minutos

Enrich Company: full guide

Todos los parámetros, campos de respuesta, jerarquía

Find Contacts: full guide

Filtros, campos de enriquecimiento, patrón de polling

Find Lookalikes: full guide

Seed → flujo de trabajo de empresas similares

MCP Setup Guide

Configuración de Claude Desktop, Cursor, Windsurf

AI Agents Overview

Todas las opciones de integración para agentes de IA