/api/v4/reviewDetailsObtenir des interactions par leurs identifiants
Renvoie les objets d’interaction complets pour un ensemble précis d’identifiants d’interaction.
Paramètres
Chaîne de requête
| Nom | Type | Obligatoire | Description | Par défaut |
|---|---|---|---|---|
| interactionIds | string | obligatoire | JSON-encoded array of interaction IDs to fetch, e.g. `["b2fa765e-c62b-4e0b-b1d6-1c67c855f5e0"]`. Passed as a URL-encoded JSON string. | — |
Réponses
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.
Récupère les détails complets des interactions correspondant à un ou plusieurs identifiants d’interaction précis. Utile lorsque vous avez enregistré des identifiants d’interaction et souhaitez obtenir des données à jour pour ces interactions sans parcourir toutes les pages de la liste des interactions. Le corps de la réponse est data.interactionDetails.interactions, un tableau d’objets d’interaction (voir la référence des attributs d’interaction).
Transmettez interactionIds sous forme de tableau JSON encodé pour une URL. Lorsqu’un identifiant n’appartient pas à votre compte, le point de terminaison renvoie 200 avec data.interactionDetails défini sur null et un tableau errors (e.g. SY90001: Not Authorized to access this resource) ; si vous omettez entièrement le paramètre, il renvoie SY90006.
Cas d’utilisation : chargement des données d’une liste de suivi enregistrée
Si vous créez un système de notification qui enregistre des identifiants d’interaction (par exemple, des avis qu’un utilisateur a marqués comme favoris), appelez régulièrement ce point de terminaison pour actualiser leurs données et détecter les nouveaux responses publiés par le propriétaire ou une modification de l’indicateur responded, sans avoir à parcourir de nouveau toute la liste des avis. La valeur responses[].id renvoyée ici correspond à la valeur responseId que vous transmettez à Modifier une réponse ou à Archiver une réponse.
curl -X GET 'https://listingsapi.com/api/v4/reviewDetails?interactionIds=<interactionIds>' \ -H "Authorization: API $LISTINGSAPI_KEY"