Référence API

L'API DataMerge

Une API REST pour l'enrichissement de données B2B. Enrichissez les entreprises par domaine, trouvez des contacts par titre de poste et localisation, parcourez les hiérarchies d'entreprises et découvrez des entreprises similaires. JSON en entrée, JSON en sortie.

Ouvrir la documentation API

Swagger UI, OpenAPI YAML. Get API key.

Base URL

api.datamerge.ai

Format

JSON / REST

Auth

API key

Processing

Async (job + poll)

Authentification

Toutes les requêtes nécessitent une clé API. Obtenez la vôtre sur app.datamerge.ai. Inscrivez-vous pour 20 crédits gratuits, sans carte bancaire requise.

En-tête de requête

Authorization: Token YOUR_API_KEY

or alternatively: X-API-Key: YOUR_API_KEY

Opérations principales

Enrichissement d'entreprise

POST /v1/company/enrich

Convertissez n'importe quel domaine en profil firmographique complet : raison sociale enregistrée, adresse, secteur d'activité, nombre d'employés, chiffre d'affaires, profils sociaux et société mère mondiale.

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édit par enregistrement réussi · 0 si non trouvé

Hiérarchie d'entreprise

GET /v1/company/hierarchy

Parcourez l'arborescence complète d'une entreprise : entités parentes, filiales et société mère mondiale, chacune avec sa propre raison sociale et son pays.

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

Retourne toutes les entités du groupe · Capacité unique (peu de fournisseurs proposent ceci)

Recherche de contacts

POST /v1/contact/search

Trouvez les décideurs d'entreprises par titre de poste, niveau hiérarchique et localisation. Enrichissez avec des adresses e-mail validées et des numéros de téléphone mobile.

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édit par e-mail · 4 crédits par mobile

Découverte d'entreprises similaires

POST /v1/company/lookalike

Trouvez des entreprises similaires à une entreprise de référence, filtrées par pays, secteur d'activité, nombre d'employés et chiffre d'affaires. Idéal pour construire des listes de prospects à partir de vos meilleurs clients.

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édit par entreprise retournée

Comment fonctionne l'API : Jobs asynchrones

Tous les endpoints d'enrichissement sont asynchrones. Chaque requête retourne immédiatement un job_id. Interrogez l'endpoint de statut jusqu'à ce que le job soit terminé. Les résultats sont inclus dans la réponse de statut.

Le schéma : toujours le même

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

Statuts du job : queued → processing → completed ou failed. Les crédits ne sont débités que sur completed avec des résultats.

Utiliser DataMerge dans des agents IA

🔌

MCP Server

Connectez Claude Desktop, Cursor ou Windsurf directement. Aucun code requis. Votre agent appelle DataMerge comme un outil natif.

https://mcp.datamerge.ai Guide de configuration →

📄

SKILL.md

Ajoutez le SKILL.md dans le contexte de votre agent. Il contient tout ce dont une IA a besoin pour comprendre et appeler correctement l'API DataMerge.

datamerge.ai/SKILL.md Voir SKILL.md →

📚

Full Docs

Une URL, toute la documentation en ligne. Conçu pour les agents IA qui ne peuvent pas suivre des liens. Récupérez une fois et ayez tout.

datamerge.ai/docs/llms.txt Ouvrir la documentation →

Ressources

Interactive Docs (Redoc)

Parcourez tous les endpoints avec des exemples en direct

Swagger UI

Testez les appels API directement dans le navigateur

OpenAPI Schema (YAML)

Spécification OpenAPI 3.0 complète pour la génération de code

Quick Start Guide

Votre premier enrichissement en 5 minutes

Enrich Company: full guide

Tous les paramètres, champs de réponse, hiérarchie

Find Contacts: full guide

Filtres, champs d'enrichissement, schéma de polling

Find Lookalikes: full guide

Seed → flux de travail entreprises similaires

MCP Setup Guide

Configuration Claude Desktop, Cursor, Windsurf

AI Agents Overview

Toutes les options d'intégration pour les agents IA