WebmeticDocs

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.

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

page?Page

Seite (0-basiert)

Bereich0 <= value
Standard0
size?Size

Treffer pro Seite (10 bis 25)

Bereich10 <= value <= 25
Standard25

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

Standardfalse
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

Standardfalse
Beispielanfrage
curl -X POST 'https://hub.webmetic.de/contacts/search' \  -H 'Content-Type: application/json' \  -d '{  "company_id": "41ea486a9c95"}'
Beispielantwort
{  "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}