Verbundene Konten auflisten

Parameter

Query

Name	Typ	Erforderlich	Beschreibung	Standard
page	integer	optional	1-based page number.	1
perPage	integer	optional	Records per page.	20
publisher	string	optional	Narrow to one publisher by account type: `GoogleAccount`, `FacebookAccount`, `AppleAccount`, `YelpAccount`, `TripadvisorAccount`, `LinkedinAccount`, `PinterestAccount`, or `TwitterAccount`.	—
status	string	optional	Narrow to one connection status: `Connected`, `NotConnected`, or `ConnectionIssue`. Note the mixed case, and that these are not the values the response's own `status` field uses.	—

Antworten

200List of connected accounts with pagination metadata.

Response

{  "data": {    "connectedAccountsInfo": {      "pageInfo": {        "hasNextPage": false,        "hasPreviousPage": false,        "totalPages": 1,        "totalRecords": 1      },      "records": [        {          "accountId": "12345",          "clientName": "owner@brightsmile-dental.com",          "connectedAccountId": "4f712c17-4f95-42dd-90f4-97171a2e67b5",          "connectedAccountType": "GoogleAccount",          "connectedLocationsCount": 0,          "connectivityIssue": null,          "email": "owner@brightsmile-dental.com",          "lastFetchMatchesRequestedAt": "2026-07-06 21:43:07 UTC",          "remarks": null,          "requestMatches": false,          "requestMatchesStatus": "MATCH_COMPLETED",          "status": "CONNECTED"        }      ]    }  }}

401Unauthenticated, missing or invalid API key.

429Rate limit exceeded. Retry after the `Retry-After` header value.

Gibt alle Google Business Profile- und Facebook Pages-Konten zurück, die für eine Verbindung mit Ihrem Listings API-Konto autorisiert sind. Jeder Datensatz enthält den Verbindungszustand (status, connectivityIssue), die Anzahl der verknüpften Standorte (connectedLocationsCount) und den Status des letzten Abrufs von Übereinstimmungen (requestMatchesStatus).

Anwendungsfall: Verbindungszustand vor einer Synchronisierung prüfen. Führen Sie diesen Aufruf zu Beginn eines nächtlichen Jobs aus, um Konten zu finden, deren Zugangsdaten abgelaufen sind. Bei jedem Datensatz, dessen connectivityIssue nicht null ist oder dessen status von CONNECTED abweicht, muss der Kunde die Verbindung über den Verbindungsablauf erneut autorisieren; überspringen Sie diese Datensätze, damit Sie keinen trigger-matches-Aufruf für ungültige Zugangsdaten verschwenden.

Anwendungsfall: Einen connectedAccountId für nachfolgende Aufrufe ermitteln. Die Endpunkte trigger-matches, fetch-listings, folders und details verwenden alle connectedAccountId als Schlüssel. Listen Sie die Konten auf, wählen Sie das Konto aus, dessen email zum Kunden passt, und verwenden Sie dessen connectedAccountId für die weiteren Aufrufe.

Paginierung und Filterung verwenden einfache, flache Abfrageparameter, kein JSON: page, perPage, publisher und status. Es gibt weder einen Parameter pageInfo, filters oder sort noch eine Möglichkeit, die Sortierung zu ändern: Die Ergebnisse werden immer aufsteigend nach der E-Mail-Adresse des Kontos sortiert. Alles andere, was Sie senden, wird ignoriert statt abgelehnt, sodass ein pageInfo im JSON-Format ohne Hinweis Seite 1 zurückgibt.

Shell

curl -s 'https://listingsapi.com/api/v4/connected-accounts?page=1&perPage=20&publisher=GoogleAccount&status=Connected' \  -H "Authorization: API $LISTINGSAPI_KEY"

Der Filter status und das Feld status verwenden unterschiedliche Wertebereiche. Der Filter akzeptiert Connected, NotConnected oder ConnectionIssue; das Feld status in jedem zurückgegebenen Datensatz hat den Wert CONNECTED, MATCH_IN_PROGRESS oder CONNECTIVITY_ISSUE. Wenn Sie den eigenen status-Wert eines Datensatzes wieder als Filter übergeben, ist dies ein ungültiger Enum-Wert und führt zur Rückgabe von 400.

Lesen Sie pageInfo.hasNextPage und pageInfo.totalPages in der Antwort, um zu entscheiden, ob Sie eine weitere Seite abrufen sollen. Aufrufe dieses Endpunkts werden auf das Ratenlimit des Kontos angerechnet; eine 429-Antwort enthält einen Retry-After-Header.