Dokumentacja API

API DataMerge

REST API do wzbogacania danych B2B. Wzbogacaj firmy po domenie, znajdź kontakty po stanowisku i lokalizacji, przeglądaj hierarchie korporacyjne i odkrywaj podobne firmy. JSON na wejściu, JSON na wyjściu.

Otwórz dokumentację API

Swagger UI, OpenAPI YAML. Get API key.

Base URL

api.datamerge.ai

Format

JSON / REST

Auth

API key

Processing

Async (job + poll)

Uwierzytelnianie

Wszystkie żądania wymagają klucza API. Uzyskaj swój na stronie app.datamerge.ai. Zarejestruj się i otrzymaj 20 darmowych kredytów, bez karty kredytowej.

Nagłówek żądania

Authorization: Token YOUR_API_KEY

or alternatively: X-API-Key: YOUR_API_KEY

Główne operacje

Wzbogacanie firm

POST /v1/company/enrich

Przekształć dowolną domenę w pełny profil firmograficzny: zarejestrowana nazwa handlowa, adres, branża, liczba pracowników, przychody, profile społecznościowe i globalna spółka matka.

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 kredyt za udany rekord · 0 jeśli nie znaleziono

Hierarchia korporacyjna

GET /v1/company/hierarchy

Przeglądaj pełne drzewo korporacyjne dowolnej firmy: podmioty nadrzędne, spółki zależne i globalna spółka matka, każda z własną nazwą handlową i krajem.

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

Zwraca wszystkie podmioty grupy · Unikalna funkcja (niewielu dostawców to oferuje)

Wyszukiwanie kontaktów

POST /v1/contact/search

Znajdź decydentów w firmach według stanowiska, poziomu seniority i lokalizacji. Wzbogać o zweryfikowane adresy e-mail i numery telefonów komórkowych.

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 kredyt za e-mail · 4 kredyty za numer komórkowy

Odkrywanie podobnych firm

POST /v1/company/lookalike

Znajdź firmy podobne do firmy referencyjnej, filtrowane według kraju, branży, liczby pracowników i przychodów. Idealne do budowania list prospektów na podstawie najlepszych klientów.

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 kredyt za zwróconą firmę

Jak działa API: Zadania asynchroniczne

Wszystkie endpointy wzbogacania są asynchroniczne. Każde żądanie natychmiast zwraca job_id. Odpytuj endpoint statusu do momentu zakończenia zadania. Wyniki są zawarte w odpowiedzi statusu.

Wzorzec: zawsze taki sam

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

Statusy zadania: queued → processing → completed lub failed. Kredyty są pobierane tylko przy completed z wynikami.

Używanie DataMerge w agentach AI

🔌

MCP Server

Połącz Claude Desktop, Cursor lub Windsurf bezpośrednio. Bez kodu. Twój agent wywołuje DataMerge jako natywne narzędzie.

https://mcp.datamerge.ai Przewodnik konfiguracji →

📄

SKILL.md

Dodaj SKILL.md do kontekstu swojego agenta. Zawiera wszystko, czego AI potrzebuje, aby poprawnie zrozumieć i wywołać API DataMerge.

datamerge.ai/SKILL.md Zobacz SKILL.md →

📚

Full Docs

Jeden URL, cała dokumentacja inline. Zaprojektowany dla agentów AI, które nie mogą podążać za linkami. Pobierz raz i miej wszystko.

datamerge.ai/docs/llms.txt Otwórz dokumentację →

Zasoby

Interactive Docs (Redoc)

Przeglądaj wszystkie endpointy z przykładami na żywo

Swagger UI

Testuj wywołania API bezpośrednio w przeglądarce

OpenAPI Schema (YAML)

Pełna specyfikacja OpenAPI 3.0 do generowania kodu

Quick Start Guide

Twoje pierwsze wzbogacanie w 5 minut

Enrich Company: full guide

Wszystkie parametry, pola odpowiedzi, hierarchia

Find Contacts: full guide

Filtry, pola wzbogacania, wzorzec pollingu

Find Lookalikes: full guide

Seed → przepływ pracy podobnych firm

MCP Setup Guide

Konfiguracja Claude Desktop, Cursor, Windsurf

AI Agents Overview

Wszystkie opcje integracji dla agentów AI