amazon/
seller-info

알고 있는 공개 Amazon 판매자 프로필 URL을 정규화된 판매자 식별 정보, 소개, 웹사이트, 평점, 피드백, 위치, 출처, 수집 시각 필드로 변환합니다.

Amazon Seller Info API

판매자 프로필 상세 정보
지원되는 마켓플레이스
URL당 레코드 1건
결과당 0.15 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

Amazon Seller Info

Amazon 판매자 프로필 페이지에는 판매자 이름, 공개 소개, 평점, 피드백 총계, 웹사이트, 위치 정보가 공개될 수 있습니다. SocQ는 알고 있는 판매자 URL의 공개 필드를 고정된 판매자 스키마로 수집하며, 비공개이거나 없거나 마켓플레이스별로 다르거나 확인할 수 없는 값은 추정하지 않고 null로 둡니다.

Amazon Seller Info API 주요 기능

  • 알고 있는 판매자 URL 수집미국, 영국, EU, 캐나다, 호주, 인도, 일본을 포함한 10개의 지원 Amazon 마켓플레이스에서 공개 판매자 프로필 URL을 하나 이상 제출합니다.
  • 안정적인 판매자 식별 정보판매자 ID, 공개 URL, 판매자 또는 사업자 이름, 소개, 연결된 웹사이트, 수집 타임스탬프를 고정된 결과 구조 하나로 받습니다.
  • 공개된 평판 지표Amazon이 공개하는 경우 원본이 보고한 rating과 feedback_count 값을 그대로 유지하며, 누락된 지표를 계산하거나 채우지 않습니다.
  • 마켓플레이스 위치 정보확인 가능한 위치 이름, 도시, 지역, 국가, 위도, 경도 필드를 저장하며, 선택적인 위치 값은 모두 null일 수 있습니다.

Amazon Seller Info API 매개변수

매개변수필수설명
urls필수공개 Amazon 판매자 참조(URL)의 필수 배열로, 비어 있으면 안 됩니다. 파싱된 호스트 이름은 지원되는 마켓플레이스 또는 서브도메인에 속해야 하며, 호스트 이름이 있는 모든 스킴과 프로토콜 상대 참조를 허용합니다. 이 상세 조회에는 판매자 프로필 경로를 사용하세요.

Amazon Seller Info API 사용 방법

공개 Amazon 판매자 프로필 URL을 제출하고, 비동기 작업을 따라간 뒤, 페이지네이션된 작업 결과에서 정규화된 판매자 레코드를 읽습니다.

  1. 지원되는 마켓플레이스의 공개 Amazon 판매자 프로필 URL을 하나 이상 복사합니다.
  2. urls 배열을 /v1/amazon/seller-info로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, has_more가 true일 때만 next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/amazon/seller-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/sp?seller=A2L77EE7U53NWQ"]}'

# Poll GET /v1/tasks/{task_id}
# Read normalized sellers from data.results.items

Amazon Seller Info API 추천 활용 사례

  • 판매자 식별 정보 매핑: 준비한 판매자 프로필 URL 목록을 일관된 판매자 ID, 이름, 공개 URL, 웹사이트, 마켓플레이스 정보로 변환합니다.
  • 평판 스냅샷: 공개 평점, 피드백 총계, collected_at 시각을 기록해 반복 가능한 특정 시점 비교에 사용하되, 값을 실시간 피드로 취급하지 않습니다.
  • 마켓플레이스 공급업체 검토: 공개 판매자 소개, 웹사이트, 위치, 피드백 지표를 원본 프로필 URL과 연결해 두는 검토 대기열을 구축합니다.

Amazon Seller Info API 활용 팁

  • /sp?seller={seller_id}와 같은 정식 판매자 프로필 링크를 제출하세요. 상품 페이지와 검색 페이지는 호스트 규칙은 통과하지만 판매자 상세 조회 입력이 아닙니다.
  • results_limit은 보내지 마세요. 백엔드는 URL마다 상세 조회 입력을 하나씩 만들고, 저장되는 결과를 제출한 비어 있지 않은 URL 수로 제한합니다.
  • 허용된 URL 하나는 판매자 레코드를 0개 또는 1개 반환할 수 있습니다. 따라서 페이지가 없거나 사용할 수 없으면 result_count가 URL 수보다 적을 수 있습니다.
  • rating과 feedback_count는 원본이 보고한 스냅샷으로 취급하고, 반복 수집한 결과를 비교할 때는 collected_at을 사용하세요.
  • 위치 필드와 website는 선택 항목입니다. null이거나 공개된 프로필 값만으로 법적 소재지, 소유 관계, 인증 여부를 추정하지 마세요.

Amazon Seller Info API 외에 Amazon의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Amazon Best Sellers API — 공개 Amazon 베스트셀러 카테고리 URL에서 상품을 수집하며, 정규화된 판매자, 가격, 평판, 판매량, 미디어, 출처, 타임스탬프 필드를 포함합니다.
  • Amazon Product Details API — 알고 있는 Amazon URL에서 상품 상세를 수집하며, 제목, 설명, 판매자, 가격, 평점, 리뷰 수, 판매량, 미디어 필드를 포함합니다.
  • Amazon Product Search API — 지원되는 Amazon 스토어에서 상품 검색어로 검색하고, 가져올 수 있는 경우 정규화된 상품, 판매자, 가격, 평점, 리뷰, 판매량, 미디어, 출처 필드를 반환합니다.
  • Amazon Reviews API — 지원되는 Amazon URL에서 공개 상품 리뷰를 수집하며, 본문, 평점, 작성자 정보, 상품 참조, 타임스탬프, 미디어를 포함합니다.
  • Amazon Storefront API — 스토어 URL로 아마존 크리에이터 스토어를 읽어 프로필, 연결된 SNS 계정, 상품 수가 포함된 아이디어 리스트, 큐레이션 게시물, 가격이 표시된 트렌딩 상품을 반환합니다.

다른 플랫폼 둘러보기

Amazon 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Amazon Seller Info API — 자주 묻는 질문

Amazon Seller Info API는 공개된 Amazon 판매자 프로필 필드를 정규화된 판매자 스키마로 수집하는 URL 기반 인터페이스입니다. 비공개 Seller Central 계정 데이터에는 접근하지 않습니다.

런타임 검증은 미국, 영국, 독일, 프랑스, 스페인, 이탈리아, 캐나다, 호주, 인도, 일본의 Amazon 호스트와 그 서브도메인을 허용합니다.

아니요. 제출한 비어 있지 않은 URL은 각각 상세 조회 입력 하나가 되어 저장된 판매자 레코드를 최대 1건 만들지만, 사용할 수 없거나 공급자 측에서 유효하지 않거나 비어 있는 페이지는 레코드를 반환하지 않을 수 있습니다.

아니요. results_limit은 허용되는 요청 필드가 아니며, 공급자는 URL마다 상세 조회 행을 하나씩 받습니다. 작업 결과 엔드포인트는 저장된 항목을 limit과 next_cursor로 페이지네이션할 수 있습니다.

정상적으로 반환된 판매자 레코드 1건당 0.15 SocQ 크레딧이 차감됩니다. 요청 시 제출한 URL 1개당 0.15 크레딧을 확보하고 실제 result_count에 맞춰 정산합니다. 성공했지만 결과가 비어 있으면 0 크레딧 기본 요금만 적용되고 사용하지 않은 예약분은 환불됩니다.