Synupv1
Schlüssel erstellen
v1Ressourcen/Locations/getStandorte mit ihren Medien auflisten

Standorte mit ihren Medien auflisten

Listet Standorte zusammen mit ihren Fotos auf, neueste zuerst — dieselben Filter wie GET /api/v1/locations. Nutzen Sie dies für Fragen wie „welche Standorte haben keine Fotos?“, statt GET /api/v1/media, das jeweils nur die Medien EINES Standorts zurückgibt.

get/api/v1/locations/media
media:read
Query-Parameter
clientIdstringoptional
Auf die Standorte eines Kunden beschränken. Erforderlich, wenn Ihr Schlüssel auf bestimmte Kunden beschränkt ist — hier gibt es kein Kundenfeld je Zeile, gegen das ein zusammengeführtes, unbeschränktes Ergebnis geprüft werden könnte, daher wird ein fehlendes clientId abgelehnt, statt es zu erraten. 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–100. Standardmäßig 100.
Antwort
dataobjectoptional
locationsarray of objectoptional
Die zu dieser Seite passenden Standorte.
idstringoptional
Eindeutige Kennung des Standorts.
namestringoptional
Der Firmenname des Standorts.
logoUrlstringoptional
URL des Logos des Standorts, oder null.
mediaByCategoryobjectoptional
Medienelemente gruppiert nach Kategorie (z. B. EXTERIOR, INTERIOR, FOOD_AND_DRINK, LOGO, TEAMS). Jedes Element hat eine url und optional ein label, ein kind (PHOTO oder VIDEO), eine source, ein starred-Flag und einen assetKey.
totalnumberoptional
Gesamtzahl der Fotos über alle Kategorien dieses Standorts hinweg.
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
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
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/media
Ihr API-Schlüssel
clientId
search
status
tags
categories
verification
createdAfter
createdBefore
cursor
limit
{
  "data": {
    "locations": [
      {
        "id": "loc_456",
        "name": "Acme Dental — Downtown",
        "logoUrl": null,
        "mediaByCategory": {
          "EXTERIOR": [
            {
              "url": "https://cdn.synup.com/media/1.jpg"
            }
          ]
        },
        "total": 1
      }
    ],
    "nextCursor": null,
    "total": 1
  }
}