사업장의 프리미엄 등록 정보 조회

이름	유형	필수	설명
locationId	string	필수	Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID.

이름

유형

필수

설명

locationId

string

필수

Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID.

응답

200Array of listings with per-directory sync status.

Response

{  "data": {    "listingsForLocation": [      {        "id": "TGlzdGluZzoxMDQ0Njg3MjM=",        "databaseId": "104468723",        "site": { "id": "U2l0ZTox", "databaseId": "1", "name": "Google Maps", "url": "maps.google.com", "syScore": "100" },        "syncStatus": "REQUIRING_ACTION",        "displayStatus": "Connect your account to sync the listing",        "actionRequired": true,        "listingUrl": null,        "connectedAccountId": null,        "lastUpdate": "2026-07-06T18:33:28Z",        "indexStatus": false,        "syncIssue": null,        "verified": false      },      {        "id": "TGlzdGluZzoxMDQ0Njg3MTQ=",        "databaseId": "104468714",        "site": { "id": "U2l0ZToxODA=", "databaseId": "180", "name": "Bing", "url": "www.bing.com", "syScore": "97" },        "syncStatus": "IN_PROGRESS",        "displayStatus": "Information submitted to partner; awaiting response",        "actionRequired": false,        "listingUrl": null,        "connectedAccountId": null,        "lastUpdate": "2026-07-06T18:33:35Z",        "indexStatus": false,        "syncIssue": null,        "verified": false      },      {        "id": "TGlzdGluZzoxMDQ0Njg3Mjc=",        "databaseId": "104468727",        "site": { "id": "U2l0ZTozODc=", "databaseId": "387", "name": "BeLocalFocussed", "url": "belocalfocussed.com", "syScore": "80" },        "syncStatus": "SYNCED",        "displayStatus": "Synced",        "actionRequired": false,        "listingUrl": "https://belocalfocussed.com/jenny-home-26x0ffkd0e",        "connectedAccountId": null,        "lastUpdate": "2026-07-06T18:33:30Z",        "indexStatus": false,        "syncIssue": null,        "verified": false      },      {        "id": "TGlzdGluZzoxMDQ0Njg3MDk=",        "databaseId": "104468709",        "site": { "id": "U2l0ZTozMDE=", "databaseId": "301", "name": "Local Mint", "url": "localmint.com", "syScore": "69" },        "syncStatus": "FAILED",        "displayStatus": "Partner experiencing issues; awaiting response",        "actionRequired": false,        "listingUrl": null,        "connectedAccountId": null,        "lastUpdate": "2026-07-06T18:34:03Z",        "indexStatus": false,        "syncIssue": "Publisher requires website URL",        "verified": false      }    ]  }}

401Unauthenticated, missing or invalid API key.

429Rate limit exceeded. Retry after the `Retry-After` header value.

사업장 요금제에 포함된 모든 게시 플랫폼 디렉터리의 동기화 상태를 반환합니다. 각 레코드는 site(디렉터리 메타데이터), syncStatus 및 사람이 읽을 수 있는 displayStatus를 함께 담고 있습니다. 위 예시는 30개 이상의 디렉터리를 반환하는 Jenny Home의 실제 응답에서 일부를 발췌하여 일반적인 각 상태에 해당하는 레코드를 하나씩 보여 줍니다.

등록 정보 등급은 경로의 일부로 지정됩니다. /listings/premium은 요금제의 프리미엄 디렉터리(여기에 표시됨)를 반환하고, /listings/additional은 추가/무료 등록 정보를 반환합니다. listingType 쿼리 매개변수는 없으며, 해당 매개변수로 전송된 값은 무시됩니다.

사용 사례: 등록 정보 상태 대시보드

사업장의 프리미엄 등록 정보를 가져와 syncStatus별로 그룹화하면 게시 중이거나, 처리 중이거나, 진행이 차단된 디렉터리 수를 통해 등록 현황을 한눈에 보여 줄 수 있습니다. SYNCED 행에는 사용자가 클릭하여 게시 중인 등록 정보로 이동할 수 있도록 listingUrl을 표시하고, 동기화되지 않은 항목은 displayStatus/syncIssue를 확인합니다(예: Publisher requires website URL).

사용 사례: "계정 연결"이 필요한 차단 요인 표시

actionRequired: true로 필터링하여 소유자의 할 일 목록을 만듭니다. 실제 데이터에서 Google Maps, Facebook, Waze는 displayStatus: "Connect your account to sync the listing"과 함께 REQUIRING_ACTION 상태로 반환되며, 동기화하려면 먼저 OAuth 연결이 필요합니다. 소유자를 해당 연결 절차로 안내한 다음, 이 엔드포인트를 다시 폴링하여 상태가 진행되는지 확인합니다.

syncStatus 값: AVAILABLE(동기화 준비 완료, 아직 시작되지 않음), IN_PROGRESS(파트너에게 제출됨, 응답 대기 중), PENDING_APPROVAL(파트너 승인 대기 중), SYNCED / COMPLETED(게시 중, listingUrl에 값이 채워짐), REQUIRING_ACTION(소유자 조치 필요, displayStatus 참조), FAILED(동기화 실패, syncIssue 참조), CANNOT_SUBMIT(제출 불가).

이 목록은 계정의 요청 빈도 제한이 적용되는 사업장별 목록이므로, 429가 반환되면 즉시 다시 폴링하지 말고 Retry-After 헤더에 지정된 시간이 지난 후에 재시도합니다.