WebmeticDocs

Ansprechpartner finden und freischalten in einem Schritt (Credits)

POST
/contacts/find

Für Automationen (n8n, Make, Zapier), wo niemand aus einer Liste auswählt: sucht wie /contacts/search, nimmt den ersten Treffer, bei dem die gewünschten Daten vorliegen (sonst den ersten mit einem Teil davon), und schaltet sie frei wie /contacts/reveal. Abgerechnet wird nur, was tatsächlich geliefert wird; bereits freigeschaltete Daten kosten nichts. Dieselbe Anfrage wählt wieder dieselbe Person, Wiederholungen sind also kostenlos. Passt niemand: found: false, nichts berechnet.

Authentifizierung

APIKeyHeader
headerAuthorization<token>

Request-Body

application/json
  1. body
company_id*Company Id

company_id eines Unternehmens, das Ihre Website besucht hat (aus /company-sessions oder /company)

filters?|

Ohne Angabe gilt die ICP-Konfiguration des Kontos

reveal?Reveal

email = E-Mail und LinkedIn, phone = Rufnummern, both = beides. Die Kosten je Aktion in Credits liefert GET /contacts/credits

Standard"email"
Wert aus"email""phone""both"

Response-Body

Der ausgewählte Kontakt mit den freigeschalteten Daten, oder found=false ohne Kosten, wenn niemand passt

application/json
  1. response

One record per call, flat so automation tools map it field by field.

found*Found

false: niemand passt zu den Filtern oder hat die gewünschten Daten; dann wurde nichts freigeschaltet und nichts berechnet

contact_id?|

Kennung des ausgewählten Kontakts

name?|

Vor- und Nachname

job_title?|

Position im Unternehmen

company_name?|

Unternehmen des Kontakts

email?|

E-Mail-Adresse; null, wenn nicht angefragt oder nicht vorhanden

linkedin?|

LinkedIn-Profil; null, wenn nicht angefragt oder nicht vorhanden

direct_phone?|

Durchwahl; null, wenn nicht angefragt oder nicht vorhanden

mobile_phone?|

Mobilnummer; null, wenn nicht angefragt oder nicht vorhanden

total*Total

Treffer der Suche, aus denen ausgewählt wurde

country?|

ISO-Ländercode des Unternehmenssitzes, auf den die Suche eingegrenzt war; null = weltweit

country_fallback?Country Fallback

true: in diesem Land gab es keine Treffer, ausgewählt wurde aus Treffern weltweit

Standardfalse
credits_used*Credits Used

Credits, die dieser Aufruf verbraucht hat

credits_remaining*Credits Remaining

Credits des Kontos nach dem Aufruf

Beispielanfrage
curl -X POST 'https://hub.webmetic.de/contacts/find' \  -H 'Content-Type: application/json' \  -d '{  "company_id": "41ea486a9c95"}'
Beispielantwort
{  "found": true,  "contact_id": "v1.abc",  "name": "Anna Beispiel",  "job_title": "Head of Marketing",  "company_name": "Bergquell Mineralbrunnen GmbH",  "email": "anna.beispiel@bergquell.example",  "linkedin": "https://www.linkedin.com/in/anna-beispiel",  "direct_phone": "+49 30 23125 417",  "mobile_phone": "+49 152 28817 386",  "total": 12,  "country": "DE",  "country_fallback": false,  "credits_used": 0,  "credits_remaining": 0}