Ansprechpartner finden und freischalten in einem Schritt (Credits)
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.
APIKeyHeaderAuthorization<token>application/json- body
company_id*Company Idcompany_id eines Unternehmens, das Ihre Website besucht hat (aus /company-sessions oder /company)
filters?|Ohne Angabe gilt die ICP-Konfiguration des Kontos
reveal?Revealemail = E-Mail und LinkedIn, phone = Rufnummern, both = beides. Die Kosten je Aktion in Credits liefert GET /contacts/credits
"email""email""phone""both"Der ausgewählte Kontakt mit den freigeschalteten Daten, oder found=false ohne Kosten, wenn niemand passt
application/json- response
One record per call, flat so automation tools map it field by field.
found*Foundfalse: 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*TotalTreffer der Suche, aus denen ausgewählt wurde
country?|ISO-Ländercode des Unternehmenssitzes, auf den die Suche eingegrenzt war; null = weltweit
country_fallback?Country Fallbacktrue: in diesem Land gab es keine Treffer, ausgewählt wurde aus Treffern weltweit
falsecredits_used*Credits UsedCredits, die dieser Aufruf verbraucht hat
credits_remaining*Credits RemainingCredits des Kontos nach dem Aufruf
curl -X POST 'https://hub.webmetic.de/contacts/find' \ -H 'Content-Type: application/json' \ -d '{ "company_id": "41ea486a9c95"}'{ "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}