GET/api/v4/reviewDetails

Obtener interacciones por sus IDs

Devuelve objetos de interacción completos para un conjunto específico de IDs de interacción.

Requiere una clave de API. Consulta Autenticación para conocer el formato del encabezado y la rotación de claves.

Parámetros

Consulta

NombreTipoObligatorioDescripciónPredeterminado
interactionIdsstringobligatorioJSON-encoded array of interaction IDs to fetch, e.g. `["b2fa765e-c62b-4e0b-b1d6-1c67c855f5e0"]`. Passed as a URL-encoded JSON string.—

Respuestas

200Interaction details for the requested IDs. `data.interactionDetails.interactions` holds the array.
Response
{  "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.

Obtiene los detalles completos de las interacciones correspondientes a uno o más IDs de interacción específicos. Resulta útil cuando has almacenado IDs de interacción y necesitas datos actualizados sobre ellas sin recorrer las páginas de toda la lista de interacciones. El cuerpo de la respuesta es data.interactionDetails.interactions, un array de objetos de interacción (consulta la referencia de atributos de interacción).

Pasa interactionIds como un array JSON codificado para URL. Cuando un ID no pertenece a tu cuenta, el endpoint devuelve 200 con data.interactionDetails establecido en null y un array errors (e.g. SY90001: Not Authorized to access this resource); si omites el parámetro por completo, devuelve SY90006.

Caso de uso: actualizar los datos de una lista de seguimiento almacenada

Si creas un sistema de notificaciones que almacena IDs de interacción (por ejemplo, de reseñas que un usuario ha marcado como favoritas), llama a este endpoint periódicamente para actualizar sus datos y detectar nuevos responses publicados por el propietario o un cambio en el indicador responded, sin necesidad de volver a recorrer toda la lista de reseñas. El valor de responses[].id que se devuelve aquí es el valor de responseId que pasas a Editar una respuesta o Archivar una respuesta.

Request
curl -X GET 'https://listingsapi.com/api/v4/reviewDetails?interactionIds=<interactionIds>' \  -H "Authorization: API $LISTINGSAPI_KEY"