100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
무료로 시작하기
Walmart logoWalmart API

Walmart 상품·리뷰 데이터 API

SocialCrawl API 키로 Walmart 검색, 상품 상세, 리뷰, 카테고리, 판매자 오퍼를 구조화 JSON으로 가져옵니다. 공유 커머스 스키마입니다. 호출은 크레딧으로 과금됩니다.

문서 보기동작 방식직접 호출
Walmart logo
/v1/walmart

활성 엔드포인트는 5개입니다. 모두 고급 티어입니다.

  • GET /v1/walmart/product
  • GET /v1/walmart/reviews
  • GET /v1/walmart/search
  • GET /v1/walmart/category
  • GET /v1/walmart/offers

Walmart 엔드포인트

Walmart 읽기 엔드포인트는 5개입니다. 상품 상세, 리뷰, 키워드 검색, 카테고리 목록, 복수 판매자 오퍼를 제공합니다. 데이터 API만 지원합니다.

상품 상세

5 크레딧
/v1/walmart/product

product_id로 Walmart 상품 상세를 가져옵니다. 제목, 가격, 평점, 이미지가 포함됩니다. 고급 티어(5 크레딧)입니다.

product_id, country

상품 리뷰

5 크레딧
/v1/walmart/reviews

Walmart product_id 리뷰입니다. 평점, 본문, 작성자, 정렬·페이지 옵션이 있습니다. 고급 티어(5 크레딧)입니다.

product_id, page, limit, sort

상품 검색

5 크레딧
/v1/walmart/search

Walmart를 키워드로 검색합니다. 상세·리뷰용 id가 있는 상품 목록입니다. 고급 티어(5 크레딧)입니다.

query

카테고리 목록

5 크레딧
/v1/walmart/category

category_id 안의 상품 목록입니다. limit을 선택할 수 있습니다. 고급 티어(5 크레딧)입니다.

category_id, limit

판매자 오퍼

5 크레딧
/v1/walmart/offers

product_id를 판매하는 모든 판매자 오퍼입니다. 가격·배송 경쟁을 봅니다. 고급 티어(5 크레딧)입니다.

product_id, country

Walmart API5개 엔드포인트 지원
문서 보기
Products
Reviews
Search

Walmart 상품을 item id로 조회해 제목, 브랜드, 판매가와 정가, 별점 분포, 이미지, 사양, 재고, 판매자까지 반환합니다.

리뷰 본문은 reviews, 다른 판매자는 offers가 맡습니다. item id로 상품 상세 전체가 필요할 때 사용하세요.

5크레딧

GET/v1/walmart/product?product_id=17835006350&country=US

product_id · Walmart product id. Either the numeric item id from the product URL (walmart.com/ip/<name>/17835006350) or the alphanumeric catalog id (34J2GQ9D9TFM). Both resolve to the same product.

$ curl https://www.socialcrawl.dev/v1/walmart/product?product_id=17835006350&country=US \
    -H "x-api-key: sc_YOUR_API_KEY"
대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

Walmart API 동작

Walmart도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/walmart/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Walmart OAuth 앱은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.

GET과 쿼리 파라미터

Walmart 라우트는 모두 GET입니다. product_id, query, category_id, country, page, limit, sort를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

Walmart 라우트 5개는 모두 고급 티어입니다. 라이브 미스는 5 크레딧입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.

연동 순서

대부분 제품은 엔티티를 먼저 찾은 뒤 필요할 때만 상세와 리뷰를 깊게 봅니다.

01검색
GET /v1/walmart/search?query=…

product_id가 있는 ProductList

상세 호출 전에 id를 확정합니다.

02상품
GET /v1/walmart/product?product_id=…

id의 전체 Product

검색 행은 전체 상세가 아닙니다.

03리뷰
GET /v1/walmart/reviews?product_id=…

정렬·페이지가 있는 ReviewList

VoC 파이프라인용 고객 언어입니다.

04오퍼
GET /v1/walmart/offers?product_id=…

오퍼 SellerList

복수 판매자 가격 확인입니다.

요청
GET /v1/walmart/search?query=airpods+pro
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

GET /v1/walmart/product?product_id=17835006350&country=US
GET /v1/walmart/reviews?product_id=17835006350&limit=50&sort=recent
응답 봉투
{
  "success": true,
  "data": {
    "product": {
      "id": "17835006350",
      "title": "Example product",
      "price": { "current": 24.99, "currency": "USD" },
      "rating": 4.3
    }
  },
  "credits_used": 5,
  "credits_remaining": 9995,
  "request_id": "req_…",
  "cached": false
}

data 형태

아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 플랫폼에 재사용합니다.

Productproduct

id, title, price, rating, images, url

ProductListsearch, category

items[]에 product_id, title, price, rating

ReviewListreviews

items[]에 rating, text, author, published_at

SellerListoffers

product_id 판매자 오퍼 행

게이트웨이 내부

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Walmart은 사이드카가 아닙니다.

  1. 01

    엣지가 호출을 받음

    Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.

  2. 02

    검증 후 차감

    레지스트리에서 walmart/search (or product, reviews, offers)를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.

  3. 03

    캐시 또는 수집

    platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 Walmart commerce upstream paths run. 소스가 불안정하면 5xx/네트워크 재시도와 서킷 브레이커를 사용합니다.

  4. 04

    정규화 후 반환

    업스트림 JSON을 Product, ProductList, ReviewList, SellerList, App, PlaceList 등 커머스 아키타입으로 매핑하고 Zod로 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.

운영에서 중요한 과금 규칙

  • 전 라우트 라이브 미스: 5 크레딧
  • 캐시 히트: 0 크레딧
  • 빈 응답 / 하드 실패: 자동 환불
  • 잘못된 파라미터: 400, 과금 없음
  • 크레딧 부족: 402, 과금 없음
  • search에서 얻은 product_id로 심화
  • category_id로 분류 탐색
  • offers는 상품 본문이 아닌 복수 판매자
  • 장바구니·결제 라우트 없음

데이터 수집 방식

Walmart은 공개 읽기 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.

이 API에서 Walmart의 의미

공개 상품 카탈로그, 리뷰, 카테고리, 판매자 오퍼입니다. 읽기 전용입니다.

SocialCrawl 수집 경로

통합 /v1 봉투 뒤의 Walmart 커머스 업스트림 경로입니다.

엣지에서 나가는 형태

공유 커머스 스키마의 Product, ProductList, ReviewList, SellerList입니다.

라이브로 제공하지 않는 것

장바구니, 재고, 매장 직원 도구는 없습니다.

필드 매핑
product_id row→ product.*title, price, rating, images
review pages→ ReviewListsort, page, limit 제어
offer matrix→ SellerListproduct_id의 전 판매자

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

5active Walmart endpoints in the registry
5 creditsproduct·reviews·search·category·offers 고급 티어

리테일 구색과 리뷰 모니터링

호출은 검색 또는 분류 후 후보 엔티티의 상세·리뷰 심화에 몰립니다. product, reviews, search, category, offers를 한 키로 5 크레딧 고급 읽기합니다.

라이브 미스는 보통 수 초입니다. 일부 경로는 콜드 캐시에서 더 걸릴 수 있습니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

리테일 분석

Python, BI

search와 category로 구색을 보고 product로 PDP 사실을 확인합니다.

VoC 팀

Node, warehouses

product_id별 reviews로 브랜드·경쟁 언어를 모읍니다.

가격 운영

Go, workers

offers와 product로 복수 판매자 가격을 확인합니다.

두 줄로 호출

Walmart 라이브 호출은 모두 5 크레딧입니다. 캐시 히트는 무료입니다.

curl "https://www.socialcrawl.dev/v1/walmart/search?query=airpods+pro" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/walmart/product?product_id=17835006350&country=US" \
  -H "x-api-key: sc_your_api_key_here"
Walmart logoSocialCrawl의 Walmart

카탈로그 전 구간과 같은 키

플랫폼 문서API 키 받기
엔드포인트

Walmart API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

ProductGet a Walmart product by idReviewsGet Walmart product reviewsSearchSearch Walmart products by keywordCategoryBrowse Walmart products in a categoryOffersGet every seller offering a Walmart product
비교

SocialCrawl과 월마트 제휴·파트너 피드, 뭐가 다른가요?

같은 Walmart 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

접근 방법

SocialCrawl
API 키 발급 후 1분이면 시작
월마트 제휴·파트너 피드
파트너 신청과 승인 필요

고객 리뷰

SocialCrawl
호출당 최대 50건, 본문과 사진 포함
월마트 제휴·파트너 피드
제공하지 않음

판매자 오퍼

SocialCrawl
상품별 모든 판매자·가격·상품 상태
월마트 제휴·파트너 피드
제공하지 않음

매장별 가격

SocialCrawl
우편번호·주·매장 ID로 조회
월마트 제휴·파트너 피드
전국 카탈로그만 제공

응답 구조

SocialCrawl
아마존·구글 쇼핑과 동일한 상품·리뷰 객체
월마트 제휴·파트너 피드
월마트 전용 피드 형식
자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
월마트 API로 어떤 데이터를 받을 수 있나요?
상품 상세(상품명, 브랜드, 모델, UPC, 가격, 정가, 별점과 1~5점 분포, 이미지 갤러리, 사양, 재고, 판매자, 반품 정책), 작성된 고객 리뷰 최대 50건, 실제 가격이 담긴 카테고리 목록, 그리고 해당 상품을 판매하는 모든 마켓플레이스 판매자의 가격과 상품 상태를 받을 수 있어요.
월마트를 키워드로 검색할 수 있나요?
지금은 안 돼요. 키워드 검색 엔드포인트를 제공했지만, 2026년 7월 28일에 상위 제공업체의 검색 백엔드가 기본값인 미국 마켓플레이스에서 오류를 내기 시작해서 내렸어요. 실패하는 엔드포인트를 그대로 두는 대신 비활성화했기 때문에 호출하면 크레딧 차감 없이 503이 돌아오고, OpenAPI 명세에도 나오지 않아요. 그동안은 카테고리 엔드포인트로 상품을 훑어 주세요. 검색과 달리 실제 가격까지 함께 반환해요.
매장별 월마트 가격도 조회할 수 있나요?
네. 카테고리 엔드포인트에 우편번호, 미국 주 코드, 특정 매장 ID를 지정하면 그 지역의 재고와 픽업 가능 여부, 취급 상품을 볼 수 있어요. 월마트는 가격과 재고가 실제로 매장마다 달라서, 전국 정가와 소비자가 실제로 보는 가격을 구분하려면 이 값이 필요해요.
walmart.ca도 지원하나요?
네. 모든 엔드포인트에서 country 파라미터를 US 또는 CA로 지정하면 walmart.com과 walmart.ca를 각각 조회해요. 상품 ID는 마켓플레이스마다 달라서, walmart.com의 ID로 walmart.ca를 조회하면 엉뚱한 상품 대신 정확하게 없음으로 응답해요.
리뷰는 한 번에 몇 건까지 가져오나요?
한 호출에 작성 리뷰 최대 50건이에요. 관련도순, 최신순, 별점순으로 정렬하거나 특정 별점만 골라 받을 수 있어요. 리뷰마다 본문, 별점, 작성자, 작성일, 도움돼요 수, 실구매 인증 여부, 리뷰 사진이 함께 와요. 마지막 페이지를 넘어가면 빈 목록이 오고 크레딧은 차감되지 않아요.
월마트 API 요금은 어떻게 되나요?
월마트 엔드포인트는 모두 호출당 5 크레딧이에요. 리뷰를 50건까지 받으면 리뷰 한 건당 0.1 크레딧인 셈이에요. 결과가 비어 있으면 요금을 받지 않아요. 상품 데이터가 없거나 마지막 페이지를 넘어간 호출은 크레딧이 자동으로 환불돼요.
Walmart 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Walmart 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Walmart 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Walmart 스크래핑 API와 공식 Walmart API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Walmart 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기Perplexity에 물어보기Gemini에 물어보기Claude에 물어보기Grok에 물어보기

Walmart API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요