/api/v4/locations-by-idsDapatkan lokasi berdasarkan ID
Mengembalikan informasi lokasi lengkap untuk sekumpulan ID lokasi yang ditentukan dalam satu permintaan.
Parameter
Query
| Nama | Tipe | Wajib | Deskripsi | Default |
|---|---|---|---|---|
| ids | string | wajib | JSON-encoded array of base64 location IDs, e.g. `["TG9jYXRpb246MTgwMDI4OQ=="]`. URL-encode the value. | — |
Respons
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.
Mengambil detail lokasi lengkap untuk sekumpulan ID tertentu dalam satu permintaan, dengan biaya jauh lebih rendah daripada satu GET per lokasi. Lokasi aktif maupun yang diarsipkan dapat ditemukan. Kirim ID sebagai array yang dikodekan dalam JSON pada parameter kueri ids dan terapkan pengodean URL pada array tersebut.
Kasus penggunaan: melengkapi data untuk sekumpulan ID dari webhook atau job. Saat Anda menerima daftar ID lokasi (dari penyimpanan Anda sendiri, payload webhook, atau penelusuran daftar lokasi yang dibagi menjadi beberapa halaman), ambil data semuanya sekaligus: ?ids=["TG9jYXRpb246MTgwMDI4OQ==","TG9jYXRpb246MTgwMDI5MA=="]. ID yang tidak ada dalam akun Anda akan dihilangkan dari array tanpa pemberitahuan dan tanpa menimbulkan kesalahan, jadi bandingkan jumlah yang dikembalikan dengan jumlah yang Anda minta untuk mendeteksi ID yang sudah tidak valid.
Perlu diperhatikan: kunci kuerinya adalah ids. Endpoint ini membaca array JSON dari parameter ids. Menggabungkan banyak ID dalam satu panggilan membuat penggunaan Anda tetap jauh di bawah batas laju dibandingkan dengan melakukan pencarian satu per satu dalam perulangan; jika Anda menjalankan pencarian tersebut secara paralel, patuhi header Retry-After saat menerima 429.
Setiap lokasi mengembalikan placeActionLinks (tautan tindakan Google yang dikelola Listings API) dan discoveredPlaceActionLinks (tautan yang ditemukan langsung di profil Google bisnis tersebut dan belum dikelola). Lihat panduan Place Action Links.
curl -X GET 'https://listingsapi.com/api/v4/locations-by-ids?ids=<ids>' \ -H "Authorization: API $LISTINGSAPI_KEY"