WebmeticDocs
Get startedDetectEnrichPersonalizeIntegrateManagePartnersDevelopers
PlaygroundContacts

Ansprechpartner bei einem identifizierten Unternehmen suchen

POST
/contacts/search

Sucht Ansprechpartner bei einem Unternehmen, das Ihre Website besucht hat (company_id aus /company-sessions oder /company). Die Suche ist kostenlos; Credits kosten erst E-Mail und Rufnummern über /contacts/reveal oder /contacts/find. Filter aus dem Body, sonst aus der ICP-Konfiguration des Kontos. Jede Seite (max. 25 Treffer) ist eine eigene Suche. Die Treffer sind auf das Sitzland des Unternehmens eingegrenzt (country, aus den Besucherdaten); gibt es dort niemanden, wird weltweit gesucht und country_fallback gesetzt.

Authorization

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

page?Page

Seite (0-basiert)

Range0 <= value
Default0
size?Size

Treffer pro Seite (10 bis 25)

Range10 <= value <= 25
Default25

Response Body

Treffer mit Verfügbarkeits-Flags; E-Mail und Rufnummer werden erst über /contacts/reveal freigeschaltet

application/json
  1. response
request_id?|

Veraltet, nur zur Information

total*Total

Treffer insgesamt

page*Page

Diese Seite, 0-basiert

contacts*array<>

Treffer dieser Seite

from_cache?From Cache

true: das Ergebnis lag schon vor und wurde nicht neu abgefragt

Defaultfalse
credits_used*Credits Used

Credits, die dieser Aufruf verbraucht hat

credits_remaining*Credits Remaining

Credits des Kontos nach dem Aufruf

country?|

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

country_fallback?Country Fallback

true: in diesem Land gab es keine Treffer, gezeigt werden Treffer weltweit

Defaultfalse
Example Request
curl -X POST 'https://hub.webmetic.de/contacts/search' \  -H 'Content-Type: application/json' \  -d '{  "company_id": "41ea486a9c95"}'
Example Response
{  "request_id": "8f1c…",  "total": 42,  "page": 0,  "contacts": [    {      "contact_id": "v1.abc",      "name": "Anna Beispiel",      "job_title": "Head of Marketing",      "company_name": "Bergquell Mineralbrunnen GmbH",      "has_email": true,      "has_phone": true,      "has_social_link": true    }  ],  "from_cache": false,  "credits_used": 0,  "credits_remaining": 0}

Gespeicherte Kontaktsuche abrufen (kostenlos) GET

Kostenlos: liefert die gespeicherte Suche dieses Kontos für das Unternehmen mit denselben Filtern.

E-Mail oder Rufnummer eines Kontakts freischalten (Credits) POST

Schaltet für einen Kontakt aus einer vorherigen Suche E-Mail (inkl. LinkedIn) und/oder Rufnummern frei.