Listings APIListings API
로그인
GET/api/v4/locations/listings/duplicates

계정의 모든 중복 등록 정보 조회

계정 내 모든 사업장에 걸쳐 잠재적인 중복 등록 정보를 계정 전체 단위로 집계하여 페이지로 나누어 반환합니다.

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

매개변수

쿼리

이름유형필수설명기본값
statusstring선택Duplicate status to return: `POTENTIAL`, `PROCESSING`, `FIXED`, or `FAILED`. Case-insensitive.POTENTIAL
siteIdinteger선택Narrow to a single publisher by site ID. See the plan-sites endpoint for valid IDs.—
tagstring선택Tag to scope the rollup to. Defaults to every location the key can see.all
pageinteger선택1-based page number.1
perPageinteger선택Records per page.—

응답

200Paginated rollup of duplicate listing records across the account.
Response
{  "data": {    "duplicateListingsRollup": {      "pageInfo": {        "hasNextPage": true,        "hasPreviousPage": false,        "totalPages": 34,        "totalRecords": 1673      },      "records": [        {          "id": "3329229",          "name": "Woodbury Train Station",          "nameValid": false,          "duplicateProcessingState": "POTENTIAL",          "liveLink": "http://citysquares.com/b/woodbury-train-station-23598450",          "locationId": "73451",          "siteName": "City Squares",          "siteUrl": "citysquares.com"        }      ]    }  }}
400An invalid `status` value, e.g. one outside `POTENTIAL` / `PROCESSING` / `FIXED` / `FAILED`.
401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.

각 사업장을 하나씩 조회하는 대신 중복 항목을 일괄적으로 검토하고 분류할 수 있도록, 모든 게시 플랫폼 디렉터리에 걸친 잠재적인 중복 등록 정보를 계정 전체 단위로 집계하여 반환합니다. 위에 표시된 pageInfo/records 구조는 계정 12345에서 실제로 검증되었습니다. 해당 계정에는 현재 미해결 중복 항목이 없으므로, 단일 레코드는 중복 항목이 있는 사업장에서 반환되는 구조를 보여 주는 예시입니다.

사용 사례: 매일 밤 중복 항목 억제를 위한 일괄 점검

계정 전체의 POTENTIAL 중복 항목을 페이지별로 조회하고 각 id를 검토자에게 전달합니다.

Code
GET /api/v4/locations/listings/duplicates?status=POTENTIAL&page=1

필터는 JSON이 아니라 중첩되지 않은 쿼리 매개변수입니다. status와 siteId는 모두 선택 사항입니다. 둘 다 제공하지 않으면 status의 기본값은 POTENTIAL, tag의 기본값은 all이므로, 매개변수 없이 GET /api/v4/locations/listings/duplicates만 호출하면 400이 아니라 계정의 미해결 중복 항목이 반환됩니다. pageInfo.hasNextPage를 사용하고 page를 증가시키면서 그 값이 false가 될 때까지 페이지별로 조회합니다. totalRecords와 totalPages를 사용하면 진행 상황을 표시할 수 있습니다.

사용 사례: 카탈로그의 일부로 범위 제한

집계에는 항상 해당 키로 조회할 수 있는 모든 사업장이 포함됩니다. 일부만 검토하려면 결과를 페이지별로 조회하여 각 레코드의 locationId를 기준으로 그룹화하거나, 원하는 사업장에 대해 사업장별 엔드포인트를 호출합니다.

처리할 id를 확보하면 등록 정보를 중복으로 표시를 사용하여 해결하거나, 등록 정보를 중복이 아닌 것으로 표시를 사용하여 잘못 탐지된 항목을 제외합니다. 단일 사업장의 중복 등록 정보를 사이트별로 그룹화하여 조회하려면 사업장의 중복 등록 정보 조회를 사용합니다. 이 엔드포인트는 페이지로 나누어 목록을 반환하며 계정의 요청 빈도 제한이 적용되므로, 429가 반환되면 Retry-After 헤더를 사용하여 재시도 대기 시간을 둡니다.

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