Listings API 개요
ListingsAPI 계정을 활성화하고 관리하는 방법을 알아보세요. 가이드는 통합을 시작하는 과정을 단계별로 안내하고, 엔드포인트 사용 안내는 리소스의 모든 엔드포인트를 다룹니다. 처음이신가요? 첫 API 호출부터 시작하세요.
여기서 시작
사업장
국가, 주 및 카테고리 조회
사업장을 생성하기 전에 지원되는 국가와 주 코드를 가져오고, 비즈니스 카테고리에 해당하는 숫자 id를 찾고, 요금제에 포함된 게시 플랫폼을 확인합니다.
가이드 읽기사업장 추가
게시 플랫폼에 필요한 필드로 사업장을 생성하고, 유효성 검사 오류를 처리하고, 제출 대기열에 추가되었는지 확인합니다.
가이드 읽기사업장 세부 정보 및 영업시간 업데이트
연락처 정보를 변경하고, 일회성 재정의가 포함된 전체 주간 영업 일정을 게시하고, 임시 휴업을 표시하고, Google 카테고리를 설정한 다음, 변경 사항을 다시 조회합니다.
가이드 읽기로고, 커버 및 사진 업로드
URL로 사업장에 로고, 커버 이미지 및 갤러리 사진을 첨부하고, 첨부된 항목을 조회하고, 대표 이미지에 별표를 지정하고, 오래된 항목을 삭제합니다.
가이드 읽기사업장 찾기 및 관리 종료 사업장 보관 처리
키워드로 검색하고, 매장 코드와 id를 일괄 조회하고, 폐점한 지점이 청구 주기 종료 시 보관 처리되도록 예약하고, 보관 처리 예약을 취소합니다.
가이드 읽기게시 플랫폼 연결
Google Business Profile 사업장 연동
Google 연결 링크를 생성하고, 소유자의 Google 등록 정보를 사업장과 매칭하고, 매칭 결과를 확인한 뒤, 아직 대응하는 사업장이 없는 등록 정보를 가져옵니다.
가이드 읽기Facebook 페이지 연결
Facebook 연결 링크를 만들고, 소유자의 페이지를 사업장과 매칭하고, 연결을 확인하거나 직접 선택하고, 고객이 서비스 이용을 종료하면 계정 연결을 해제합니다.
가이드 읽기Apple Business Connect 연결
소유자의 인증된 Apple Business 계정을 통해, 또는 해당 계정이 없으면 ListingsAPI 계정을 통해 사업장을 Apple Maps에 게시한 다음, 등록 정보를 확인하고 고객이 서비스를 해지하면 연결을 해제합니다.
가이드 읽기사업장의 새 Google Business Profile
연결된 Google 계정 아래의 사업장에 새 Google Business Profile 생성 요청을 제출한 다음, 해당 사업장, 등록 정보, 웹훅을 통해 인증 진행 상황을 확인합니다.
가이드 읽기등록 정보
등록 정보 상태 확인 및 공개 URL 가져오기
사업장의 모든 게시 플랫폼별 동기화 상태를 조회하고, 공개된 등록 정보의 URL을 수집하고, 게시 현황을 요약하고, 음성 비서를 확인하고, 폴링 대신 웹훅으로 알림을 받습니다.
가이드 읽기등록 정보 오류 찾기 및 수정
사업장의 등록 정보에서 주의가 필요한 행만 필터링하고, 게시 플랫폼이 제공한 사유를 확인한 뒤, 해당하는 수정 조치를 적용하고, 안전하게 다시 폴링하고, 계정 전체를 점검합니다.
가이드 읽기중복 등록 정보 찾기 및 노출 중단
사업장별 및 계정 전체에서 감지된 중복 등록 정보를 조회하고, 실제 중복 항목의 노출 중단을 확정하고, 오탐 항목을 제외하고, 각 항목이 해결될 때까지 추적합니다.
가이드 읽기리뷰
사업장 1곳 또는 계정 전체의 리뷰 가져오기
사업장의 최신 리뷰를 나열하고, 답글이 없는 낮은 평점의 리뷰로 필터링하고, 커서로 페이지를 탐색하고, 계정 전체를 조회하고, 웹훅으로 알림을 받습니다.
가이드 읽기리뷰에 답글을 작성한 후 답글 수정 또는 보관하기
소유자 답글을 허용하는 리뷰를 찾아 답글을 게시하고, 게시 플랫폼에 전달되었는지 확인한 다음, 문구를 수정하거나 답글을 보관합니다.
가이드 읽기리뷰 성과 측정
사업장의 리뷰 KPI를 조회하고, 일별 추이를 차트로 표시하고, 소스를 비교하고, 자주 등장하는 문구를 추출하고, 웹훅으로 일간 및 주간 스냅샷을 받습니다.
가이드 읽기게시물
분석
자동화
AI 에이전트
엔드포인트 사용 안내
사업장
목록 조회, 검색, id 및 매장 코드로 조회, 생성, 업데이트, 보관 처리, 사진 관리를 다루는 모든 사업장 엔드포인트를 사용 순서대로 소개하며, 각 엔드포인트에 cURL, Python 및 Node 예제를 제공합니다.
가이드 읽기등록 정보
모든 등록 정보 엔드포인트와 각 엔드포인트의 cURL, Python 및 Node 예제: 프리미엄 동기화 상태, 음성 비서, 사업장별 및 계정별 중복 탐지, 중복 등록 정보 노출 중단을 다룹니다.
가이드 읽기연결된 계정
cURL, Python 및 Node 예제가 포함된 모든 연결된 계정 엔드포인트를 다룹니다: Google 및 Facebook 연결, 계정 목록 조회, 등록 정보 매칭 및 연결, 폴더, GMB 생성, 연결 해제.
가이드 읽기리뷰
cURL, Python 및 Node 예제가 포함된 모든 리뷰 엔드포인트를 다룹니다: 소스 및 설정, 목록, 통합 조회, 상세 정보, 답글, 수정, 보관 처리, 문구, 분석.
가이드 읽기게시물
모든 Posts 엔드포인트와 각 엔드포인트의 cURL, Python 및 Node 예제: 공지, 이벤트 및 혜택, 예약, 사업장별 캠페인과 일괄 캠페인, 상태 폴링 및 삭제.
가이드 읽기Social
모든 Social 엔드포인트를 다룹니다. 브랜드, 호스팅된 연결 링크, 단일 및 일괄 게시, 예약, 인사이트, 그리고 이 모든 기능에 적용되는 연결 한도를 설명합니다.
가이드 읽기분석
모든 프로필 분석 엔드포인트와 각 엔드포인트의 cURL, Python 및 Node 예제: 사업장의 일별 Google 및 Facebook 지표와 주별 Bing 조회 수를 확인합니다.
가이드 읽기보조 API
지원되는 국가와 주, 하위 카테고리 카탈로그, 요금제에 포함된 게시 플랫폼 사이트를 조회하는 모든 보조 API 엔드포인트와 각 엔드포인트의 cURL, Python 및 Node 예제입니다.
가이드 읽기