Walmart API

Walmart API를 사용하면 제품을 검색하고 제품 ID별로 상세 정보를 얻을 수 있습니다. 두 엔드포인트 모두 기기 에뮬레이션, 배송 지역 설정 및 주문 처리 필터를 지원합니다.

엔드포인트

엔드포인트	설명
`POST /api/v1/walmart/search`	정렬, 페이지 매기기, 가격 및 주문 처리 필터를 사용한 Walmart 제품 검색
`POST /api/v1/walmart/product`	Walmart 제품 ID로 상세 제품 정보 가져오기

인증

헤더	값	필수
`Authorization`	`Bearer YOUR_API_KEY`	예
`Content-Type`	`application/json`	예

제품 검색

Bash

POST https://api.scavio.dev/api/v1/walmart/search

Walmart 제품을 검색하고 가격, 평점, 재고 여부 등 구조화된 결과를 얻습니다.

요청 본문

매개변수	유형	기본값	설명
`query`	`string`	--	필수. 검색어 (1-500자).
`domain`	`string`	`""`	Walmart 도메인.
`device`	`string`	`desktop`	기기 유형. 다음 중 하나: `desktop`, `mobile`, `tablet`
`sort_by`	`string`	`best_match`	정렬 순서. 다음 중 하나: `best_match`, `price_low`, `price_high`, `best_seller`
`start_page`	`integer`	`1`	시작 페이지 번호 (1부터 시작).
`min_price`	`integer`	--	최소 가격 필터 (달러).
`max_price`	`integer`	--	최대 가격 필터 (달러).
`fulfillment_speed`	`string`	--	배송 속도 필터. 다음 중 하나: `today`, `tomorrow`, `2_days`, `anytime`
`fulfillment_type`	`string`	--	주문 처리 유형 필터. 현재 지원: `in_store`
`delivery_zip`	`string`	--	배송 우편번호 (지역화된 결과 및 재고 확인용).
`store_id`	`string`	--	매장 재고 확인용 Walmart 매장 ID.

예시

curl -X POST 'https://api.scavio.dev/api/v1/walmart/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "best_seller",
    "min_price": 20,
    "max_price": 100
  }'

응답 예시

JSON

{
  "data": {
    "page": 1,
    "products_count": 40,
    "location": {
      "city": "Jacksonville",
      "state": "FL",
      "store_id": "5054",
      "zipcode": "32246"
    },
    "products": [
      {
        "id": "123456789",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/ip/Sony-WH-1000XM5/123456789",
        "image": "https://i5.walmartimages.com/...",
        "price": 248.0,
        "price_strikethrough": null,
        "currency": "USD",
        "rating": 4.7,
        "rating_count": 8230,
        "sponsored": false,
        "out_of_stock": false,
        "seller_name": "Walmart.com",
        "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
        "fulfillment": {
          "delivery": true,
          "free_shipping": true,
          "pickup": true,
          "shipping": true
        },
        "pos": 1,
        "variants": []
      }
    ],
    "url": "https://www.walmart.com/search?q=...",
    "html": "",
    "screenshot": ""
  },
  "response_time": 1920,
  "credits_used": 1,
  "credits_remaining": 999
}

제품 상세

Bash

POST https://api.scavio.dev/api/v1/walmart/product

특정 Walmart 제품의 상세 정보를 제품 ID로 가져옵니다. 가격, 설명, 사양, 이미지, 평점 및 판매자 정보를 반환합니다.

요청 본문

매개변수	유형	기본값	설명
`product_id`	`string`	--	필수. Walmart 제품 ID (예: `123456789`).
`domain`	`string`	--	Walmart 도메인.
`device`	`string`	`desktop`	기기 유형. 다음 중 하나: `desktop`, `mobile`, `tablet`
`delivery_zip`	`string`	--	지역화된 가격 확인용 배송 우편번호.
`store_id`	`string`	--	매장 재고 확인용 Walmart 매장 ID.

예시

curl -X POST 'https://api.scavio.dev/api/v1/walmart/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"product_id": "123456789"}'

응답 예시

JSON

{
  "data": {
    "id": "123456789",
    "sku": "123456789",
    "gtin": "012345678901",
    "price": 248.0,
    "price_strikethrough": 349.99,
    "currency": "USD",
    "rating": 4.7,
    "rating_count": 8230,
    "out_of_stock": false,
    "seller_name": "Walmart.com",
    "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
    "seller_url": null,
    "image": "https://i5.walmartimages.com/...",
    "images": [
      "https://i5.walmartimages.com/..."
    ],
    "fulfillment": {
      "delivery": true,
      "delivery_information": "Arrives today",
      "free_shipping": true,
      "fulfilled_by": "",
      "out_of_stock": false,
      "pickup": true,
      "pickup_information": "Pickup today",
      "shipping": true,
      "shipping_information": "Free shipping"
    },
    "specifications": [
      { "key": "Brand", "value": "Sony" },
      { "key": "Wireless technology", "value": "Bluetooth" }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2310,
  "credits_used": 1,
  "credits_remaining": 998
}

응답 형식

두 엔드포인트 모두 일관된 응답 래퍼를 반환합니다:

필드	유형	설명
`data`	`object \| null`	응답 페이로드. 업스트림 요청이 실패하면 `null`입니다. 검색은 `{page, products, location, ...}`를 반환하고, 제품은 제품 객체를 직접 반환합니다.
`response_time`	`number`	서버 측 응답 시간 (밀리초)
`credits_used`	`number`	사용된 크레딧 수
`credits_remaining`	`number`	현재 청구 기간에 남은 크레딧

오류 응답

상태	설명
`401`	인증되지 않음 - API 키가 없거나 유효하지 않음
`429`	요금제 한도 또는 사용량 초과
`502`	업스트림 오류 - 잠시 후 재시도
`503`	업스트림 서비스를 사용할 수 없음 - 나중에 재시도

전체 오류 참조 및 재시도 모범 사례는 오류를 참조하세요.

Walmart API

엔드포인트

엔드포인트	설명
`POST /api/v1/walmart/search`	정렬, 페이지 매기기, 가격 및 주문 처리 필터를 사용한 Walmart 제품 검색
`POST /api/v1/walmart/product`	Walmart 제품 ID로 상세 제품 정보 가져오기

인증

헤더	값	필수
`Authorization`	`Bearer YOUR_API_KEY`	예
`Content-Type`	`application/json`	예

제품 검색

Bash

POST https://api.scavio.dev/api/v1/walmart/search

Walmart 제품을 검색하고 가격, 평점, 재고 여부 등 구조화된 결과를 얻습니다.

요청 본문

매개변수	유형	기본값	설명
`query`	`string`	--	필수. 검색어 (1-500자).
`domain`	`string`	`""`	Walmart 도메인.
`device`	`string`	`desktop`	기기 유형. 다음 중 하나: `desktop`, `mobile`, `tablet`
`sort_by`	`string`	`best_match`	정렬 순서. 다음 중 하나: `best_match`, `price_low`, `price_high`, `best_seller`
`start_page`	`integer`	`1`	시작 페이지 번호 (1부터 시작).
`min_price`	`integer`	--	최소 가격 필터 (달러).
`max_price`	`integer`	--	최대 가격 필터 (달러).
`fulfillment_speed`	`string`	--	배송 속도 필터. 다음 중 하나: `today`, `tomorrow`, `2_days`, `anytime`
`fulfillment_type`	`string`	--	주문 처리 유형 필터. 현재 지원: `in_store`
`delivery_zip`	`string`	--	배송 우편번호 (지역화된 결과 및 재고 확인용).
`store_id`	`string`	--	매장 재고 확인용 Walmart 매장 ID.

예시

curl -X POST 'https://api.scavio.dev/api/v1/walmart/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "best_seller",
    "min_price": 20,
    "max_price": 100
  }'

응답 예시

JSON

{
  "data": {
    "page": 1,
    "products_count": 40,
    "location": {
      "city": "Jacksonville",
      "state": "FL",
      "store_id": "5054",
      "zipcode": "32246"
    },
    "products": [
      {
        "id": "123456789",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/ip/Sony-WH-1000XM5/123456789",
        "image": "https://i5.walmartimages.com/...",
        "price": 248.0,
        "price_strikethrough": null,
        "currency": "USD",
        "rating": 4.7,
        "rating_count": 8230,
        "sponsored": false,
        "out_of_stock": false,
        "seller_name": "Walmart.com",
        "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
        "fulfillment": {
          "delivery": true,
          "free_shipping": true,
          "pickup": true,
          "shipping": true
        },
        "pos": 1,
        "variants": []
      }
    ],
    "url": "https://www.walmart.com/search?q=...",
    "html": "",
    "screenshot": ""
  },
  "response_time": 1920,
  "credits_used": 1,
  "credits_remaining": 999
}

제품 상세

Bash

POST https://api.scavio.dev/api/v1/walmart/product

특정 Walmart 제품의 상세 정보를 제품 ID로 가져옵니다. 가격, 설명, 사양, 이미지, 평점 및 판매자 정보를 반환합니다.

요청 본문

매개변수	유형	기본값	설명
`product_id`	`string`	--	필수. Walmart 제품 ID (예: `123456789`).
`domain`	`string`	--	Walmart 도메인.
`device`	`string`	`desktop`	기기 유형. 다음 중 하나: `desktop`, `mobile`, `tablet`
`delivery_zip`	`string`	--	지역화된 가격 확인용 배송 우편번호.
`store_id`	`string`	--	매장 재고 확인용 Walmart 매장 ID.

예시

curl -X POST 'https://api.scavio.dev/api/v1/walmart/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"product_id": "123456789"}'

응답 예시

JSON

{
  "data": {
    "id": "123456789",
    "sku": "123456789",
    "gtin": "012345678901",
    "price": 248.0,
    "price_strikethrough": 349.99,
    "currency": "USD",
    "rating": 4.7,
    "rating_count": 8230,
    "out_of_stock": false,
    "seller_name": "Walmart.com",
    "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
    "seller_url": null,
    "image": "https://i5.walmartimages.com/...",
    "images": [
      "https://i5.walmartimages.com/..."
    ],
    "fulfillment": {
      "delivery": true,
      "delivery_information": "Arrives today",
      "free_shipping": true,
      "fulfilled_by": "",
      "out_of_stock": false,
      "pickup": true,
      "pickup_information": "Pickup today",
      "shipping": true,
      "shipping_information": "Free shipping"
    },
    "specifications": [
      { "key": "Brand", "value": "Sony" },
      { "key": "Wireless technology", "value": "Bluetooth" }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2310,
  "credits_used": 1,
  "credits_remaining": 998
}

응답 형식

두 엔드포인트 모두 일관된 응답 래퍼를 반환합니다:

필드	유형	설명
`data`	`object \| null`	응답 페이로드. 업스트림 요청이 실패하면 `null`입니다. 검색은 `{page, products, location, ...}`를 반환하고, 제품은 제품 객체를 직접 반환합니다.
`response_time`	`number`	서버 측 응답 시간 (밀리초)
`credits_used`	`number`	사용된 크레딧 수
`credits_remaining`	`number`	현재 청구 기간에 남은 크레딧

오류 응답

상태	설명
`401`	인증되지 않음 - API 키가 없거나 유효하지 않음
`429`	요금제 한도 또는 사용량 초과
`502`	업스트림 오류 - 잠시 후 재시도
`503`	업스트림 서비스를 사용할 수 없음 - 나중에 재시도

전체 오류 참조 및 재시도 모범 사례는 오류를 참조하세요.

Walmart API

엔드포인트

인증

제품 검색

요청 본문

예시

응답 예시

제품 상세

요청 본문

예시

응답 예시

응답 형식

오류 응답

관련 항목

Walmart API

엔드포인트

인증

제품 검색

요청 본문

예시

응답 예시

제품 상세

요청 본문

예시

응답 예시

응답 형식

오류 응답

관련 항목