/api/v4/locations-by-idsStandorte anhand von IDs abrufen
Gibt vollständige Standortinformationen für eine angegebene Gruppe von Standort-IDs in einer einzigen Anfrage zurück.
Parameter
Query
| Name | Typ | Erforderlich | Beschreibung | Standard |
|---|---|---|---|---|
| ids | string | erforderlich | JSON-encoded array of base64 location IDs, e.g. `["TG9jYXRpb246MTgwMDI4OQ=="]`. URL-encode the value. | — |
Antworten
200Array of full location objects, one per resolved ID. Unknown IDs are omitted.
{ "data": { "getLocationsByIds": [ { "id": "TG9jYXRpb246MTgwMDI4OQ==", "databaseId": 1800289, "accountId": 12345, "storeId": null, "name": "Jenny Home", "archived": false, "archivedAt": null, "street": "600 Congress Ave, Suite 200", "city": "Austin", "stateIso": "TX", "postalCode": "78701", "countryIso": "US", "countryCode": "1", "latitude": "30.2711286", "longitude": "-97.7436995", "phone": "5125550142", "additionalPhones": [], "bizUrl": null, "hideAddress": false, "categoryId": 15, "subCategoryId": 1432, "subCategoryName": "Restaurants", "additionalCategoryIds": [], "description": "This is a standalone duplex house. A comfortable, private residence located in the Bouldin Creek neighborhood of Austin, offering spacious duplex living with easy access to the surrounding South Congress area and downtown Austin.", "contentPreferredLanguage": "ENGLISH", "businessHours": [], "moreHours": [], "package": "PREMIUM", "planId": 3797, "planName": "Launch", "temporarilyClosed": false, "ownerName": null, "ownerEmail": null, "paymentMethods": [], "locationPhotos": [], "isRestaurant": true, "voiceStatus": 3, "yearOfIncorporation": null, "placeActionLinks": [ { "placeActionType": "FOOD_ORDERING", "uri": "https://order.example.com", "isPreferred": true, "name": "locations/1944.../placeActionLinks/54ada85bc246058a", "submissionStatus": "success", "submissionMessage": "Already up to date on Google.", "lastSubmittedAt": "2026-07-08T12:14:36Z" } ], "discoveredPlaceActionLinks": [ { "placeActionType": "APPOINTMENT", "uri": "https://book.example.com", "isPreferred": false, "name": "locations/1944.../placeActionLinks/abc123", "providerType": "MERCHANT", "isEditable": true } ] } ] }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
Ruft vollständige Standortdetails für eine bestimmte Gruppe von IDs in einer einzigen Anfrage ab, was deutlich kostengünstiger ist als ein GET pro Standort. Sowohl aktive als auch archivierte Standorte können abgerufen werden. Übergeben Sie die IDs als JSON-kodiertes Array im Abfrageparameter ids und kodieren Sie es für die URL.
Anwendungsfall: Details zu einer Gruppe von IDs aus einem Webhook oder Job abrufen. Wenn Sie eine Liste von Standort-IDs erhalten (aus Ihrem eigenen Datenspeicher, einer Webhook-Nutzlast oder dem Durchlaufen einer paginierten Standortliste), rufen Sie die zugehörigen Standorte alle auf einmal ab: ?ids=["TG9jYXRpb246MTgwMDI4OQ==","TG9jYXRpb246MTgwMDI5MA=="]. IDs, die in Ihrem Konto nicht existieren, werden ohne Fehlermeldung aus dem Array entfernt, statt einen Fehler auszulösen. Vergleichen Sie daher die Anzahl der zurückgegebenen Standorte mit der angefragten Anzahl, um veraltete IDs zu erkennen.
Achtung: Der Abfrageschlüssel lautet ids. Dieser Endpunkt liest das JSON-Array aus dem Parameter ids. Wenn Sie viele IDs in einem Aufruf bündeln, bleiben Sie deutlich unter dem Anfragelimit, verglichen mit einzelnen Abfragen in einer Schleife; falls Sie diese parallel ausführen, beachten Sie bei einem 429 den Header Retry-After.
Für jeden Standort werden placeActionLinks (die von Listings API verwalteten Google-Aktionslinks) und discoveredPlaceActionLinks (Links, die direkt im Google-Profil des Unternehmens gefunden wurden und noch nicht verwaltet werden) zurückgegeben. Weitere Informationen finden Sie im Leitfaden zu Place Action Links.
curl -X GET 'https://listingsapi.com/api/v4/locations-by-ids?ids=<ids>' \ -H "Authorization: API $LISTINGSAPI_KEY"