/api/v4/reviewDetailsMendapatkan interaksi berdasarkan ID
Mengembalikan objek interaksi lengkap untuk sekumpulan ID interaksi tertentu.
Parameter
Query
| Nama | Tipe | Wajib | Deskripsi | Default |
|---|---|---|---|---|
| interactionIds | string | wajib | JSON-encoded array of interaction IDs to fetch, e.g. `["b2fa765e-c62b-4e0b-b1d6-1c67c855f5e0"]`. Passed as a URL-encoded JSON string. | — |
Respons
200Interaction details for the requested IDs. `data.interactionDetails.interactions` holds the array.
{ "data": { "interactionDetails": { "interactions": [ { "id": "b2fa765e-c62b-4e0b-b1d6-1c67c855f5e0", "source": "maps.google.com", "content": "Great place for dessert!", "authorName": "Jordan M.", "category": "Review", "type": "Review", "rating": 5, "date": "2026-05-12T09:22:41+00:00", "responded": true, "responseCount": 1, "canRespond": true, "responses": [ { "id": "2090753a-ece6-4837-8336-8494ad308523", "content": "Thank you so much for the kind words!", "authorName": "Jenny Home", "date": "2026-05-13T14:02:00+00:00", "interactionStatus": "CONFIRMED", "editedResponse": false } ] } ] } }}401Unauthenticated, missing or invalid API key.
Mengambil detail interaksi lengkap untuk satu atau beberapa ID interaksi tertentu. Berguna ketika Anda telah menyimpan ID interaksi dan memerlukan data terbarunya tanpa menelusuri seluruh daftar interaksi halaman demi halaman. Isi responsnya adalah data.interactionDetails.interactions, sebuah array objek interaksi (lihat referensi atribut interaksi).
Kirimkan interactionIds sebagai array JSON yang dikodekan untuk URL. Jika suatu ID tidak termasuk dalam akun Anda, endpoint mengembalikan 200 dengan data.interactionDetails diatur ke null dan sebuah array errors (e.g. SY90001: Not Authorized to access this resource); jika parameter tersebut tidak disertakan sama sekali, endpoint mengembalikan SY90006.
Kasus penggunaan: memuat data terbaru untuk daftar pantauan yang disimpan
Jika Anda membangun sistem notifikasi yang menyimpan ID interaksi (misalnya, ulasan yang diberi bintang oleh pengguna), panggil endpoint ini secara berkala untuk memuat ulang data terbarunya dan mendeteksi responses yang baru diposting oleh pemilik atau perubahan pada flag responded, tanpa perlu memindai ulang seluruh daftar ulasan. responses[].id yang dikembalikan di sini adalah responseId yang Anda kirimkan ke Mengedit respons atau Mengarsipkan respons.
curl -X GET 'https://listingsapi.com/api/v4/reviewDetails?interactionIds=<interactionIds>' \ -H "Authorization: API $LISTINGSAPI_KEY"