/api/v4/locations/{locationId}/listings/duplicates사업장의 중복 등록 정보 조회
단일 사업장에서 감지된 중복 등록 정보 항목을 게시 플랫폼 사이트별로 그룹화하여 반환합니다.
매개변수
경로
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| locationId | string | 필수 | Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID. |
응답
200Duplicate listings grouped by site. Each group carries the primary listing plus an array of detected duplicates.
{ "data": { "duplicateListingsForLocation": [ { "id": "U2l0ZToxNTA=", "name": "City Squares", "url": "citysquares.com", "listings": [ { "id": "RHVwbGljYXRlOjIzNTk4NDUw", "listingItemId": "TGlzdGluZ0l0ZW06MjM1OTg0NTA=", "name": "Woodbury Train Station", "liveLink": "http://citysquares.com/b/woodbury-train-station-23598450", "status": "POTENTIAL" } ] } ] }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
사업장 1곳에서 감지된 모든 중복 등록 정보를 게시 플랫폼 사이트별로 그룹화하여 반환합니다. 각 그룹은 사이트(name, url)이며, 중복 가능성이 있는 항목의 listings 배열을 포함하고 각 중복 항목에는 listingItemId 및 status가 있습니다. 실제 운영 중인 사업장 Jenny Home에는 현재 중복 항목이 없어 {"data":{"duplicateListingsForLocation":[]}}을 반환하므로, 위에서 항목이 채워진 그룹은 중복 항목이 있는 사업장에서 반환하는 구조의 예시입니다.
사용 사례: 로컬 SEO에 악영향을 주는 중복 항목 정리
중복된 디렉터리 항목은 순위 결정 신호를 분산시키고 고객에게 혼란을 줍니다. 사업장의 이 목록을 조회하고 각 그룹을 검토한 다음, 실제로 중복된 항목에 조치를 취합니다. 각 항목의 listingItemId는 등록 정보를 중복으로 표시의 listingItemIds 배열에 필요한 값과 정확히 일치합니다:
{ "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]}실제로 올바른 등록 정보인 항목은 등록 정보를 중복 아님으로 표시를 사용해 제외하여 여기에 더 이상 표시되지 않도록 합니다.
사용 사례: 계정 전체 점검 후 사업장별 상세 정보 확인
계정의 모든 중복 등록 정보 조회로 미처리 중복 항목이 있는 사업장을 확인한 후 이 엔드포인트를 사용하여 단일 사업장의 상세 정보를 살펴봅니다. 계정 전체 요약은 어디에 중복 항목이 있는지 알려주고, 이 엔드포인트는 어떤 항목인지 사이트별로 그룹화하여 알려줍니다.
status는 처리 상태를 나타냅니다: POTENTIAL(감지되었으나 아직 조치를 취하지 않음), PROCESSING, FIXED 또는 FAILED입니다. 이 목록은 사업장별 목록이며 계정의 요청 빈도 제한이 적용되므로, 429가 반환되면 Retry-After 헤더에 지정된 시간이 지난 후 다시 시도합니다.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/listings/duplicates' \ -H "Authorization: API $LISTINGSAPI_KEY"