Referência API

A API DataMerge

Uma API REST para enriquecimento de dados B2B. Enriqueça empresas por domínio, encontre contatos por cargo e localização, percorra hierarquias corporativas e descubra empresas similares. JSON de entrada, JSON de saída.

Abrir documentação API

Swagger UI, OpenAPI YAML. Get API key.

Base URL

api.datamerge.ai

Format

JSON / REST

Auth

API key

Processing

Async (job + poll)

Autenticação

Todas as requisições exigem uma chave API. Obtenha a sua em app.datamerge.ai. Cadastre-se para 20 créditos gratuitos, sem cartão de crédito necessário.

Cabeçalho da requisição

Authorization: Token YOUR_API_KEY

or alternatively: X-API-Key: YOUR_API_KEY

Operações principais

Enriquecimento de empresa

POST /v1/company/enrich

Converta qualquer domínio em um perfil firmográfico completo: razão social registrada, endereço, setor, número de funcionários, receita, perfis sociais e empresa controladora 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 bem-sucedido · 0 se não encontrado

Hierarquia corporativa

GET /v1/company/hierarchy

Percorra a árvore corporativa completa de qualquer empresa: entidades controladoras, subsidiárias e a empresa controladora global, cada uma com sua própria razão social e país.

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

Retorna todas as entidades do grupo · Capacidade única (poucos provedores oferecem isso)

Busca de contatos

POST /v1/contact/search

Encontre tomadores de decisão em empresas por cargo, nível de senioridade e localização. Enriqueça com endereços de e-mail validados e números de celular.

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 e-mail · 4 créditos por celular

Descoberta de empresas similares

POST /v1/company/lookalike

Encontre empresas similares a uma empresa de referência, filtradas por país, setor, número de funcionários e receita. Ideal para construir listas de prospectos a partir dos seus melhores 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 retornada

Como a API funciona: Jobs assíncronos

Todos os endpoints de enriquecimento são assíncronos. Cada requisição retorna imediatamente um job_id. Consulte o endpoint de status até que o job seja concluído. Os resultados estão incluídos na resposta de status.

O padrão: sempre o mesmo

# 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", ... }]
#   }

Status do job: queued → processing → completed ou failed. Os créditos só são cobrados em completed com resultados.

Usando DataMerge em agentes de IA

🔌

MCP Server

Conecte Claude Desktop, Cursor ou Windsurf diretamente. Sem código necessário. Seu agente chama o DataMerge como uma ferramenta nativa.

https://mcp.datamerge.ai Guia de configuração →

📄

SKILL.md

Adicione o SKILL.md ao contexto do seu agente. Ele contém tudo o que uma IA precisa para entender e chamar corretamente a API DataMerge.

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

📚

Full Docs

Uma URL, toda a documentação inline. Projetado para agentes de IA que não podem seguir links. Busque uma vez e tenha tudo.

datamerge.ai/docs/llms.txt Abrir documentação →

Recursos

Interactive Docs (Redoc)

Explore todos os endpoints com exemplos ao vivo

Swagger UI

Teste chamadas API diretamente no navegador

OpenAPI Schema (YAML)

Especificação completa OpenAPI 3.0 para geração de código

Quick Start Guide

Seu primeiro enriquecimento em 5 minutos

Enrich Company: full guide

Todos os parâmetros, campos de resposta, hierarquia

Find Contacts: full guide

Filtros, campos de enriquecimento, padrão de polling

Find Lookalikes: full guide

Seed → fluxo de trabalho de empresas similares

MCP Setup Guide

Configuração de Claude Desktop, Cursor, Windsurf

AI Agents Overview

Todas as opções de integração para agentes de IA