API-Referenz

Die DataMerge API

Eine REST API für B2B-Datenanreicherung. Unternehmen nach Domain anreichern, Kontakte nach Jobtitel und Standort finden, Unternehmenshierarchien durchsuchen und ähnliche Unternehmen entdecken. JSON rein, JSON raus.

API-Dokumentation öffnen

Swagger UI, OpenAPI YAML. Get API key.

Base URL

api.datamerge.ai

Format

JSON / REST

Auth

API key

Processing

Async (job + poll)

Authentifizierung

Alle Anfragen erfordern einen API-Schlüssel. Holen Sie sich Ihren unter app.datamerge.ai. Registrieren Sie sich für 20 kostenlose Credits, keine Kreditkarte erforderlich.

Anfrage-Header

Authorization: Token YOUR_API_KEY

or alternatively: X-API-Key: YOUR_API_KEY

Kernoperationen

Unternehmen anreichern

POST /v1/company/enrich

Konvertieren Sie eine beliebige Domain in ein vollständiges firmografisches Profil: eingetragener Handelsname, Adresse, Branche, Mitarbeiterzahl, Umsatz, Social-Profile und globale Muttergesellschaft.

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 pro erfolgreichem Datensatz · 0 für nicht gefunden

Unternehmenshierarchie

GET /v1/company/hierarchy

Durchsuchen Sie den vollständigen Unternehmensbaum für ein beliebiges Unternehmen: Muttergesellschaften, Tochtergesellschaften und die globale Muttergesellschaft, jeweils mit Handelsname und Land.

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

Gibt alle Unternehmen der Gruppe zurück · Einzigartige Funktion (wenige Anbieter bieten dies an)

Kontaktsuche

POST /v1/contact/search

Entscheidungsträger bei Unternehmen nach Jobtitel, Seniorität und Standort finden. Mit validierten E-Mail-Adressen und Mobilnummern anreichern.

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 pro E-Mail · 4 Credits pro Mobilnummer

So funktioniert die API: Asynchrone Jobs

Alle Anreicherungsendpunkte sind asynchron. Jede Anfrage gibt sofort eine job_id zurück. Pollieren Sie den Status-Endpunkt bis der Job abgeschlossen ist. Ergebnisse sind in der Status-Antwort enthalten.

Das Muster: immer gleich

# 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-Status: queued → processing → completed oder failed. Credits werden nur bei completed mit Ergebnissen berechnet.

DataMerge in KI-Agenten verwenden

🔌

MCP Server

Claude Desktop, Cursor oder Windsurf direkt verbinden. Kein Code erforderlich. Ihr Agent ruft DataMerge als natives Werkzeug auf.

https://mcp.datamerge.ai Einrichtungsanleitung →

📄

SKILL.md

Fügen Sie die SKILL.md in den Kontext Ihres Agenten ein. Sie enthält alles, was eine KI benötigt, um die DataMerge API korrekt zu verstehen und aufzurufen.

datamerge.ai/SKILL.md SKILL.md ansehen →

📚

Full Docs

Eine URL, alle Dokumentation inline. Entwickelt für KI-Agenten, die keine Links folgen können. Einmal abrufen und alles haben.

datamerge.ai/docs/llms.txt Dokumentation öffnen →

Ressourcen

Interactive Docs (Redoc)

Alle Endpunkte mit Live-Beispielen durchsuchen

Swagger UI

API-Aufrufe direkt im Browser testen

OpenAPI Schema (YAML)

Vollständige OpenAPI 3.0 Spezifikation für Code-Generierung

Quick Start Guide

Ihre erste Anreicherung in 5 Minuten

Enrich Company: full guide

Alle Parameter, Antwortfelder, Hierarchie

Find Contacts: full guide

Filter, Anreicherungsfelder, Polling-Muster

Find Lookalikes: full guide

Seed → ähnliche Unternehmen Workflow

MCP Setup Guide

Claude Desktop, Cursor, Windsurf Konfiguration

AI Agents Overview

Alle Integrationsoptionen für KI-Agenten