API Reference

The DataMerge API

A REST API for B2B data enrichment. Enrich companies by domain, find contacts by job title and location, traverse corporate hierarchies, and discover lookalike companies. JSON in, JSON out.

Open API Docs

Swagger UI, OpenAPI YAML. Get API key.

Base URL

api.datamerge.ai

Format

JSON / REST

Auth

API key

Processing

Async (job + poll)

Authentication

All requests require an API key. Get yours at app.datamerge.ai. Sign up for 20 free credits, no credit card required.

Request header

Authorization: Token YOUR_API_KEY

or alternatively: X-API-Key: YOUR_API_KEY

Core Operations

Company Enrichment

POST /v1/company/enrich

Convert any domain into a full firmographic profile: registered legal name, address, industry, employee count, revenue, social profiles, and global ultimate holding company.

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 credit per successful record · 0 for not found

Corporate Hierarchy

GET /v1/company/hierarchy

Traverse the full corporate tree for any company: parent entities, subsidiaries, and the global ultimate holding company, each with their own legal name and country.

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

Returns all entities in the group · Unique capability (few providers offer this)

Contact Search

POST /v1/contact/search

Find decision-makers at companies by job title, seniority, and location. Enrich with validated email addresses and mobile phone numbers.

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 credit per email · 4 credits per mobile

Lookalike Discovery

POST /v1/company/lookalike

Find companies similar to a seed company, filtered by country, industry, employee count, and revenue. Ideal for building prospect lists from your best customers.

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 credit per company returned

How the API Works: Async Jobs

All enrichment endpoints are asynchronous. Every request returns a job_id immediately. Poll the status endpoint until the job completes. Results are embedded in the status response.

The pattern: always the same

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

Job statuses: queued → processing → completed or failed. Credits are only charged on completed with results.

Using DataMerge in AI Agents

🔌

MCP Server

Connect Claude Desktop, Cursor, or Windsurf directly. No code required. Your agent calls DataMerge as a native tool.

https://mcp.datamerge.ai Setup guide →

📄

SKILL.md

Drop the SKILL.md into your agent's context. It contains everything an AI needs to understand and call the DataMerge API correctly.

datamerge.ai/SKILL.md View SKILL.md →

📚

Full Docs

One URL, all documentation inlined. Designed for AI agents that can't follow links. Fetch once and have everything.

datamerge.ai/docs/llms.txt Open docs →

Resources

Interactive Docs (Redoc)

Browse every endpoint with live examples

Swagger UI

Try API calls directly in the browser

OpenAPI Schema (YAML)

Full OpenAPI 3.0 spec for code generation

Quick Start Guide

Your first enrichment in 5 minutes

Enrich Company: full guide

All parameters, response fields, hierarchy

Find Contacts: full guide

Filters, enrich fields, polling pattern

Find Lookalikes: full guide

Seed → similar companies workflow

MCP Setup Guide

Claude Desktop, Cursor, Windsurf config

AI Agents Overview

All integration options for AI agents