/api/v4/locations-by-idsRecupera le sedi tramite ID
Restituisce le informazioni complete sulle sedi per un insieme specificato di ID di sede in un'unica richiesta.
Parametri
Query
| Nome | Tipo | Obbligatorio | Descrizione | Predefinito |
|---|---|---|---|---|
| ids | string | obbligatorio | JSON-encoded array of base64 location IDs, e.g. `["TG9jYXRpb246MTgwMDI4OQ=="]`. URL-encode the value. | — |
Risposte
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.
Recupera i dettagli completi delle sedi per un insieme specifico di ID in un'unica richiesta, con un costo molto inferiore rispetto a una richiesta GET per sede. Vengono recuperate sia le sedi attive sia quelle archiviate. Passa gli ID come array codificato in JSON nel parametro di query ids e applica la codifica URL al valore.
Caso d'uso: recuperare i dettagli di un gruppo di ID provenienti da un webhook o da un job. Quando ricevi un elenco di ID di sede (dal tuo archivio, dal payload di un webhook o da una scansione paginata dell'elenco delle sedi), recupera i dettagli di tutte le sedi in un'unica operazione: ?ids=["TG9jYXRpb246MTgwMDI4OQ==","TG9jYXRpb246MTgwMDI5MA=="]. Gli ID che non esistono nel tuo account vengono omessi dall'array senza alcuna segnalazione, anziché generare un errore, quindi confronta il numero di elementi restituiti con quello richiesto per individuare gli ID obsoleti.
Attenzione: la chiave di query è ids. Questo endpoint legge l'array JSON dal parametro ids. Raggruppare molti ID in un'unica chiamata ti permette di restare ben al di sotto del limite di frequenza rispetto all'esecuzione di singole ricerche in un ciclo; se esegui comunque le richieste in parallelo, rispetta l'header Retry-After quando ricevi una risposta 429.
Per ogni sede vengono restituiti placeActionLinks (i link di azione di Google gestiti da Listings API) e discoveredPlaceActionLinks (i link trovati direttamente sul profilo Google dell'attività che non sono ancora gestiti). Consulta la guida ai link di azione dei luoghi.
curl -X GET 'https://listingsapi.com/api/v4/locations-by-ids?ids=<ids>' \ -H "Authorization: API $LISTINGSAPI_KEY"