Listings APIListings API
로그인
GET/api/v4/reviews/site-config

계정의 리뷰 소스 목록 조회

계정에서 사용할 수 있는 리뷰 플랫폼을 반환합니다. Google Maps와 Facebook은 모든 요금제에서 사용할 수 있으며, Yelp는 Growth와 Enterprise에서 사용할 수 있습니다.

API 키가 필요합니다. 헤더 형식과 키 교체는 인증을 참고하세요.

매개변수

이 엔드포인트는 매개변수를 받지 않습니다.

응답

200Account-level review source catalog.
Response
{  "data": {    "interactionSiteConfig": [      { "site": "Google", "siteUrl": "maps.google.com" },      { "site": "Facebook", "siteUrl": "facebook.com" },      { "site": "Yelp", "siteUrl": "yelp.com" }    ]  }}
401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.

계정의 구독에 따라 이용 권한이 부여된 리뷰 소스 플랫폼의 전체 카탈로그를 반환합니다. 위 응답은 Launch 요금제 계정의 실시간 카탈로그이며, 정확한 사이트 구성은 요금제와 업종에 따라 달라집니다.

사용 사례: 사업장을 구성하기 전에 name 값 검증

siteUrl 필드는 리뷰 API의 다른 모든 곳에서 사용하는 표준 사이트 식별자입니다. 리뷰 소스는 사업장의 Google 및 Facebook 프로필을 연결하면 자동으로 채워지며, 수동으로 추가하거나 편집하는 단계는 없습니다. 이 카탈로그를 사용하여 상호작용 목록 엔드포인트에서 사용할 수 있는 유효한 siteUrls 필터 값을 확인합니다.

사용 사례: "리뷰 연결" UI 구축

사업장 소유자가 각 플랫폼의 프로필 URL을 붙여넣을 수 있도록 반환된 사이트마다 행을 하나씩 표시합니다. 이 계정 전체 카탈로그(연결 가능한 소스)를 사업장의 리뷰 소스 목록 조회(사업장 1개에 이미 연결된 소스)와 함께 사용하여 연결된 소스와 연결 가능한 소스를 표시합니다.

이 엔드포인트는 매개변수를 받지 않고 계정 범위로 작동하므로 호출 간에 결과가 일정하며, 사업장마다 다시 가져오는 대신 캐시합니다. 계정의 요청 빈도 제한이 적용되며, 429가 반환되면 Retry-After 헤더를 사용하여 재시도 간격을 늘립니다.

Request
curl -X GET 'https://listingsapi.com/api/v4/reviews/site-config' \  -H "Authorization: API $LISTINGSAPI_KEY"
Run in playground