GET/v1/walmart/search?query=wool+socks
업데이트 2026-11-03
마켓플레이스 API로 무엇을 할 수 있나요?
마켓플레이스 API는 AliExpress, Amazon, Shopify, TikTok Shop 및 Walmart의 공개 상품 데이터를 하나의 상품 스키마로 돌려줍니다. 상품명, 가격, 평점, 판매자, 재고, 배송 정보가 어느 마켓플레이스에서 왔든 같은 이름으로 오고, 한 마켓플레이스에만 있는 정보는 버리지 않고 ext에 담습니다.
검색이나 카테고리에서 시작해 항목의 id를 product에 넘기면 상품 전체 정보를 받고, 마켓플레이스가 제공하면 리뷰도 읽을 수 있습니다. 모든 기능과 파라미터, 비용은 API 레퍼런스에 있습니다.
API 레퍼런스 열기기능
- search
- 키워드 검색. 마켓플레이스가 지원하면 가격·카테고리 필터도 씁니다.5개 소스
- product
- 상품 페이지 하나를 마켓플레이스가 보여주는 그대로 전부.5개 소스
- browse
- 키워드 없이 카테고리의 상품 목록.4개 소스
- categories
- 마켓플레이스의 카테고리 트리와 각 카테고리의 id.4개 소스
- image-search
- 이미지로 검색. 이미지 URL을 보냅니다.3개 소스
- reviews
- 상품 리뷰를 페이지 단위로.3개 소스
- catalog
- 스토어의 상품을 페이지 단위로.2개 소스
- shipping
- 상품을 도착 국가로 보낼 때의 배송 옵션과 배송비.1개 소스
curl "https://gateway.apinoa.com/v1/walmart/search?query=wool+socks" \ -H "x-api-key: $APINOA_API_KEY"
상품 데이터를 위해 만들었습니다
하나의 상품 스키마
모든 마켓플레이스가 같은 필드로 응답하므로, 파서 하나로 5곳을 모두 처리합니다.
검색에서 상품으로
검색 결과의 각 항목에 product가 받는 id가 들어 있어, 별도 매칭 없이 결과 목록을 상품 상세로 이어갈 수 있습니다.
필터 이름은 하나
가격 범위와 카테고리 필터는 이를 지원하는 모든 마켓플레이스에서 같은 이름입니다.
이미지로 검색
이미지 URL을 보내면 AliExpress, Amazon 및 Shopify에서 일치하는 상품을 받습니다.
Amazon 16개국
구매자 국가로 스토어를 고르면 가격, 재고, 배송이 그에 맞춰집니다.
최대 비용을 먼저
모든 기능은 호출하기 전에 최대 비용을 공개합니다.
모든 소스, 모든 기능
API 레퍼런스 기준으로, 소스마다 지금 응답하는 기능입니다.
| 소스 | search | product | browse | categories | image-search | reviews | catalog | shipping |
|---|---|---|---|---|---|---|---|---|
| AliExpress | ||||||||
| Amazon | ||||||||
| Shopify | ||||||||
| TikTok Shop | ||||||||
| Walmart |
AI 에이전트에게
마켓플레이스·소셜·검색 데이터를
Claude Code, Cursor 등 MCP 클라이언트에 MCP 서버를 추가하거나, TypeScript·Python SDK로 바로 개발하세요. 키 하나로 모두 쓸 수 있고, 저장소는 모두 공개되어 있습니다.
MCP 서버
Claude, Cursor 등 에이전트에서 API 사용
GitHub에서 보기npx -y apinoa-mcpTypeScript SDK
Node, Deno, Bun용 타입 지정 클라이언트
GitHub에서 보기npm install @apinoa/sdkPython SDK
동기·비동기 Python 클라이언트
GitHub에서 보기pip install apinoa
쓴 만큼만 냅니다
요금제도, 최소 금액도 없습니다. $20부터 충전하면 요청마다 잔액에서 차감됩니다. 하루에 많이 보낼수록 건당 가격이 내려갑니다.
- 마켓플레이스·소셜 데이터
- 요청당 $0.001
실패한 요청은 무료입니다. 평가용 무료 크레딧 $1을 신청할 수 있으며, 카드 등록은 필요 없습니다.
- 하루 비용
- $10.00
- 요청당 평균
- $0.00083
- 이 속도로 30일
- $300
많이 충전할수록 저렴하게
$5,000 이상 충전하면 8~20%의 보너스 크레딧이 결제 확인 즉시 더해집니다.
매일 같은 대량 작업을 돌리시나요?
월 고정 가격으로 맞춰 드립니다. 문의하기
자주 묻는 질문
어떤 마켓플레이스를 조회할 수 있나요?
AliExpress, Amazon, Shopify, TikTok Shop 및 Walmart입니다. 각 마켓플레이스의 기능, 파라미터, 비용은 API 레퍼런스에 있습니다.
스크레이퍼를 직접 만들지 않고 API를 호출하는 이유는 무엇인가요?
호출 한 번이 상품 한 페이지를 JSON으로 돌려줍니다. 브라우저를 띄우거나 HTML을 파싱할 필요가 없습니다. 모든 마켓플레이스가 같은 상품 스키마로 응답하고, v1 안에서는 필드가 추가될 뿐이며, 실패한 요청은 과금되지 않습니다.
모든 마켓플레이스가 같은 필드를 돌려주나요?
네. 검색 결과와 상품은 하나의 상품 스키마로 오기 때문에 같은 필드는 어디서나 이름이 같습니다. 마켓플레이스가 보여주지 않는 정보는 필드가 없고, 한 마켓플레이스에만 있는 정보는 ext에 담깁니다.
검색 결과의 상세 정보는 어떻게 받나요?
검색 결과의 각 항목에는 마켓플레이스 고유의 상품 id가 들어 있습니다. 이 값을 product 기능에 id로 넘기면 됩니다.
국가를 고를 수 있나요?
Amazon에서는 16개국 스토어를 region으로 고를 수 있고, 가격과 재고, 배송이 그에 따라 달라집니다. 마켓플레이스별로 지원하는 국가는 API 레퍼런스의 각 페이지에 나와 있습니다.
결과를 더 받으려면 어떻게 하나요?
마켓플레이스에 따라 페이지 번호나 이전 페이지가 돌려준 커서로 다음 페이지를 받습니다. 페이지 하나가 요청 하나입니다.
요청 하나의 비용은 얼마인가요?
대부분의 기능은 마켓플레이스 단가로 요청 하나만큼 과금되고, 하루 사용량이 늘수록 단가가 내려갑니다. 비용이 더 드는 일부 기능은 API 레퍼런스에 표시되어 있으며, 실패한 요청은 과금되지 않습니다.