Synupv1
Schlüssel erstellen
v1Ressourcen/Locations/getStandorte auflisten / suchen

Standorte auflisten / suchen

Liefert eine Seite von Standorten, neueste zuerst. Alle Filter sind optional und werden kombiniert (ein Standort muss allen entsprechen); um weitere Ergebnisse zu blättern, geben Sie den zurückgegebenen nextCursor erneut mit.

get/api/v1/locations
locations:read
Query-Parameter
clientIdstringoptional
Ergebnisse auf einen Kunden beschränken. Ist Ihr Schlüssel auf bestimmte Kunden beschränkt, muss dies einer davon sein. Nachschlagen mit GET /api/v1/clients.
searchstringoptional
Freitextsuche über Name, Straßenadresse, Stadt oder Telefonnummer des Standorts (Groß-/Kleinschreibung wird ignoriert, Teiltreffer erlaubt).
statusstring (all | active | archived | archival_pending | verification_pending | unapproved | requires_action)optional
Ein einzelner Statusbereich: all, active (nicht archiviert), archived, archival_pending, verification_pending (Google-Freigabe ausstehend), unapproved oder requires_action. Standardmäßig all.
tagsarray of stringoptional
Interne Tags — trifft auf einen Standort zu, der mindestens eines davon hat.
categoriesarray of stringoptional
Anzeigenamen von Kategorien — trifft auf einen Standort zu, dessen allgemeine oder Google-Kategorie eine davon ist.
verificationarray of string (verified | pending | unverified | unknown)optional
Google-Verifizierungsstatus: verified, pending, unverified oder unknown.
createdAfterstringoptional
Nur Standorte, die an oder nach diesem Datum erstellt wurden.
createdBeforestringoptional
Nur Standorte, die an oder vor diesem Datum erstellt wurden.
cursorstringoptional
Paginierungs-Cursor aus dem nextCursor einer vorherigen Antwort. Für die erste Seite leer lassen.
limitintegeroptional
Standorte pro Seite, 1–200. Standardmäßig 50.
Antwort
dataobjectoptional
locationsarray of objectoptional
Die zu dieser Seite passenden Standorte.
idstringoptional
Eindeutige Kennung des Standorts.
namestringoptional
Der Firmenname des Standorts.
addressstringoptional
Die Straßenadresse des Standorts (zusammengeführte Straßenzeilen), oder null.
citystringoptional
Stadt.
statestringoptional
Bundesland oder Region.
postalCodestringoptional
Postleitzahl, oder null.
countrystringoptional
Land, als ISO-3166-1-Alpha-2-Code, oder null.
phonestringoptional
Primäre Telefonnummer, oder null.
websitestringoptional
Die Website-URL des Standorts, oder null.
storeCodestringoptional
Ihr interner Filialcode / Referenz für diesen Standort, oder null.
categorystringoptional
Die Anzeigekategorie des Standorts (publisherspezifische Primärkategorie, falls gesetzt, sonst die allgemeine Kategorie), oder null.
tagsarray of stringoptional
Interne Tags für Ihre eigene Organisation — nicht öffentlich sichtbar.
labelsarray of stringoptional
Interne Labels für diesen Standort.
statusstring (active | archived | archival_pending | verification_pending | unapproved | requires_action)optional
Abgeleiteter Status: active, archived, archival_pending, verification_pending (Google-Freigabe ausstehend), unapproved oder requires_action.
verificationStatusstring (verified | pending | unverified | unknown)optional
Google-Verifizierungsstatus: verified, pending, unverified oder unknown, oder null.
pendingChangesnumberoptional
Anzahl der gespeicherten Änderungen, die zur Veröffentlichung eingereiht, aber noch nicht mit den verbundenen Verzeichnissen synchronisiert wurden.
lastPublishedAtstringoptional
Wann die Details dieses Standorts zuletzt erfolgreich mit einem Publisher synchronisiert wurden, als ISO-8601-Zeitstempel, oder null.
clientIdstringoptional
ID des Kunden, zu dem dieser Standort gehört, oder null.
clientNamestringoptional
Firmenname des Kunden, zu dem dieser Standort gehört, oder null.
createdAtstringoptional
Zeitpunkt der Erstellung des Standorts, als ISO-8601-Zeitstempel.
nextCursorstringoptional
Paginierungs-Cursor für die nächste Seite, oder null, wenn keine weiteren Ergebnisse vorliegen.
totalnumberoptional
Gesamtzahl der Standorte, die den Filtern entsprechen, über alle Seiten hinweg.
Fehler
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/locations
Ihr API-Schlüssel
clientId
search
status
tags
categories
verification
createdAfter
createdBefore
cursor
limit
{
  "data": [
    {
      "id": "loc_456",
      "name": "Acme Dental — Downtown",
      "city": "Austin",
      "state": "TX",
      "clientId": "cli_123",
      "createdAt": "2026-01-15T10:05:00.000Z"
    }
  ]
}