Synupv1
Schlüssel erstellen
v1Ressourcen/Connections/getVerbundene Konten auflisten

Verbundene Konten auflisten

Liefert die verbundenen Publisher-/Social-Konten Ihrer Agentur (Google, Facebook, Instagram, LinkedIn, TikTok und weitere), optional gefiltert nach Kunde oder Plattform.

get/api/v1/connections
connections:read
Query-Parameter
clientIdstringoptional
Ergebnisse auf einen Kunden beschränken. Ist Ihr Schlüssel auf bestimmte Kunden beschränkt, sind die Ergebnisse auch ohne diese Angabe immer auf diese Kunden vorgefiltert.
platformstringoptional
Ergebnisse auf eine Plattform beschränken, z. B. facebook, google.
credentialsValidbooleanoptional
Auf Konten beschränken, deren gespeicherte Zugangsdaten derzeit gültig (true) oder ungültig (false) sind.
fetchStatusstringoptional
Auf Konten mit diesem Abrufstatus beschränken.
cursorstringoptional
Paginierungs-Cursor aus dem nextCursor einer vorherigen Antwort.
limitintegeroptional
Maximal zurückzugebende Konten, 1–100. Standardmäßig 20.
Antwort
dataobjectoptional
accountsarray of objectoptional
Die passenden verbundenen Konten.
idstringoptional
Eindeutige Kennung des verbundenen Kontos.
platformstringoptional
Die Plattform, mit der dieses Konto verbunden ist, z. B. google, facebook, instagram.
displayNamestringoptional
Anzeigename des verbundenen Kontos.
providerAccountIdstringoptional
Die eigene Kennung der Plattform für dieses Konto.
credentialsValidbooleanoptional
Ob die gespeicherten Zugangsdaten derzeit gültig sind.
fetchStatusstringoptional
Aktueller Abrufstatus für dieses Konto, z. B. idle, fetching.
fetchErrorstringoptional
Die letzte Fehlermeldung beim Abruf, oder null.
errorTagstringoptional
Ein kurzer, maschinenlesbarer Fehlercode, oder null.
gmbGroupIdsarray of stringoptional
Google-Business-Profil-Gruppen-IDs, die mit diesem Konto verknüpft sind, falls vorhanden.
expiresAtstringoptional
Wann das Access Token dieses Kontos abläuft, als ISO-8601-Zeitstempel, oder null.
dataAccessExpiresAtstringoptional
Wann das Datenzugriffsfenster von Meta für dieses Konto abläuft, als ISO-8601-Zeitstempel, oder null.
channelstringoptional
Der Kanal, über den diese Verbindung hergestellt wurde.
clientIdstringoptional
ID des Kunden, zu dem dieses Konto gehört, oder null bei einer agenturweiten Verbindung.
synupLocationIdstringoptional
Legacy-Standortkennung. Veraltet — clientLocationId bevorzugen.
clientLocationIdstringoptional
ID des Standorts, an den dieses Konto gebunden ist, oder null. Gegenüber synupLocationId zu bevorzugen.
fetchedListingsCountnumberoptional
Anzahl der von diesem Konto abgerufenen Listings.
lastFetchedAtstringoptional
Wann dieses Konto zuletzt einen Abruf abgeschlossen hat, als ISO-8601-Zeitstempel, oder null.
connectionStatusstring (CONNECTED | MISSING | RENEW | DISCONNECTED | SUSPENDED | SUGGESTED_MATCH)optional
Gesamtzustand dieser Verbindung: CONNECTED, MISSING, RENEW, DISCONNECTED, SUSPENDED oder SUGGESTED_MATCH.
createdAtstringoptional
Wann dieses Konto verbunden wurde, als ISO-8601-Zeitstempel.
updatedAtstringoptional
Wann dieses Konto zuletzt aktualisiert wurde, als ISO-8601-Zeitstempel.
nextCursorstringoptional
Paginierungs-Cursor für die nächste Seite, oder null, wenn keine weiteren Ergebnisse vorliegen.
totalCountnumberoptional
Gesamtzahl der zur Anfrage passenden Konten.
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/connections
Ihr API-Schlüssel
clientId
platform
credentialsValid
fetchStatus
cursor
limit
{
  "data": {
    "accounts": [
      {
        "id": "conn_1",
        "platform": "google",
        "displayName": "Acme Dental — Google",
        "providerAccountId": "112233445566",
        "credentialsValid": true,
        "fetchStatus": "ok",
        "fetchError": null,
        "errorTag": null,
        "gmbGroupIds": [],
        "expiresAt": null,
        "dataAccessExpiresAt": "2026-05-01T00:00:00.000Z",
        "channel": "local",
        "clientId": "cli_123",
        "synupLocationId": null,
        "clientLocationId": "loc_456"
      }
    ],
    "nextCursor": null,
    "totalCount": 1
  }
}