/api/v4/reviewDetailsRecuperare le interazioni tramite ID
Restituisce gli oggetti completi delle interazioni per un insieme specifico di ID di interazione.
Parametri
Query
| Nome | Tipo | Obbligatorio | Descrizione | Predefinito |
|---|---|---|---|---|
| interactionIds | string | obbligatorio | JSON-encoded array of interaction IDs to fetch, e.g. `["b2fa765e-c62b-4e0b-b1d6-1c67c855f5e0"]`. Passed as a URL-encoded JSON string. | — |
Risposte
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.
Recupera i dettagli completi delle interazioni per uno o più ID di interazione specifici. Utile quando hai memorizzato degli ID di interazione e ti servono dati aggiornati senza dover scorrere tutte le pagine dell'elenco delle interazioni. Il corpo della risposta è data.interactionDetails.interactions, un array di oggetti interazione (vedi il riferimento agli attributi delle interazioni).
Passa interactionIds come array JSON con codifica URL. Quando un ID non appartiene al tuo account, l'endpoint restituisce 200 con data.interactionDetails impostato su null e un array errors (e.g. SY90001: Not Authorized to access this resource); se ometti del tutto il parametro, restituisce SY90006.
Caso d'uso: recuperare i dati completi di un elenco di elementi monitorati salvato
Se crei un sistema di notifiche che memorizza gli ID delle interazioni (ad esempio, le recensioni che un utente ha contrassegnato con una stella), chiama periodicamente questo endpoint per ricaricarne i dati completi e rilevare nuovi responses pubblicati dal proprietario o una modifica al flag responded, senza dover esaminare nuovamente l'intero elenco delle recensioni. Il valore di responses[].id restituito qui è il valore di responseId che passi a Modificare una risposta o Archiviare una risposta.
curl -X GET 'https://listingsapi.com/api/v4/reviewDetails?interactionIds=<interactionIds>' \ -H "Authorization: API $LISTINGSAPI_KEY"