WebmeticDocs

Unternehmen taggen

POST
/company-tags

Gibt den Unternehmen hinter den Domains einen Tag, wie der CSV-Import im Dashboard. Ein neuer Tag-Name legt den Tag an. Das Unternehmen muss Ihre Website noch nicht besucht haben: der Tag steht schon da, wenn es kommt. Bestehende Tags bleiben, ein zweiter Aufruf mit derselben Liste ändert nichts.

Authentifizierung

APIKeyHeader
headerAuthorization<token>

Request-Body

application/json
  1. body
tag*Tag

Name des Tags, z. B. 'Zielkunde'. Groß- und Kleinschreibung zählt nicht; ein neuer Name legt den Tag an (nur POST).

Länge1 <= length <= 100
domains*array<string>

1 bis 10.000 Domains oder URLs der Unternehmen, z. B. 'acme.de'.

Einträge1 <= items <= 10000

Response-Body

Getaggt

application/json
  1. response
tagged*Tagged

Domains, deren Unternehmen den Tag jetzt trägt; auch wenn es ihn schon hatte

unknown*array<string>

Eingaben ohne Unternehmen im Register, unverändert zurückgegeben

Beispielanfrage
curl -X POST 'https://hub.webmetic.de/company-tags' \  -H 'Content-Type: application/json' \  -d '{  "tag": "Zielkunde",  "domains": [    "bergquell.example",    "hagedorn.example"  ]}'
Beispielantwort
{  "tagged": 2,  "unknown": [    "gibtesnicht.example"  ]}