GET
/api/v4/reviewDetailsID로 상호작용 조회
지정된 상호작용 ID 집합에 해당하는 전체 상호작용 객체를 반환합니다.
매개변수
쿼리
| 이름 | 유형 | 필수 | 설명 | 기본값 |
|---|---|---|---|---|
| interactionIds | string | 필수 | JSON-encoded array of interaction IDs to fetch, e.g. `["b2fa765e-c62b-4e0b-b1d6-1c67c855f5e0"]`. Passed as a URL-encoded JSON string. | — |
응답
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.
지정된 1개 이상의 상호작용 ID에 대한 전체 세부 정보를 가져옵니다. 저장된 상호작용 ID가 있고 전체 상호작용 목록을 페이지별로 조회하지 않고도 해당 ID의 최신 데이터가 필요할 때 유용합니다. 응답 본문은 상호작용 객체의 배열인 data.interactionDetails.interactions입니다(상호작용 속성 참조 참조).
interactionIds를 URL 인코딩된 JSON 배열로 전달합니다. ID가 현재 계정에 속하지 않으면 엔드포인트는 data.interactionDetails가 null로 설정되고 errors 배열이 포함된 200을 반환합니다(예: SY90001: Not Authorized to access this resource). 매개변수를 완전히 생략하면 SY90006을 반환합니다.
사용 사례: 저장된 관심 목록을 최신 데이터로 갱신
상호작용 ID를 저장하는 알림 시스템을 구축하는 경우(예: 사용자가 별표를 표시한 리뷰), 이 엔드포인트를 주기적으로 호출하여 해당 상호작용을 최신 데이터로 갱신하고 소유자가 새로 게시한 responses 또는 변경된 responded 플래그를 감지할 수 있으며, 전체 리뷰 목록을 다시 확인할 필요가 없습니다. 여기서 반환되는 responses[].id는 답글 수정 또는 답글 보관에 전달하는 responseId입니다.
Request
curl -X GET 'https://listingsapi.com/api/v4/reviewDetails?interactionIds=<interactionIds>' \ -H "Authorization: API $LISTINGSAPI_KEY"