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을 제출하고, 비동기 작업을 따라간 뒤, 페이지네이션된 작업 결과에서 정규화된 판매자 레코드를 읽습니다.
- 지원되는 마켓플레이스의 공개 Amazon 판매자 프로필 URL을 하나 이상 복사합니다.
- urls 배열을 /v1/amazon/seller-info로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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.itemsAmazon 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이거나 공개된 프로필 값만으로 법적 소재지, 소유 관계, 인증 여부를 추정하지 마세요.
관련 API
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 계정, 상품 수가 포함된 아이디어 리스트, 큐레이션 게시물, 가격이 표시된 트렌딩 상품을 반환합니다.