{
  "openapi": "3.0.1",
  "info": {
    "title": "Walmart Scraper — Products, Prices, Sellers & Reviews",
    "description": "Scrape Walmart.com and Walmart.ca: products with price, was-price, every deal badge, rating, seller and stock; full records with UPC, specs and variants; customer reviews with star, verified and date filters; every seller offer with seller email and phone. Any URL, keyword or item id.",
    "version": "0.0",
    "x-build-id": "Ot0l2b63ViYt02izI"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~walmart-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-walmart-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/memo23~walmart-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-walmart-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/memo23~walmart-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-walmart-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "scrapeMode": {
            "title": "Result type",
            "enum": [
              "products",
              "reviews",
              "sellerOffers"
            ],
            "type": "string",
            "description": "What each product turns into. Values: products, reviews, sellerOffers. Seller offers are available for walmart.com only. Seller store URLs always return a seller profile row. Example: products. Default: products.",
            "default": "products"
          },
          "startUrls": {
            "title": "Walmart URLs",
            "type": "array",
            "description": "Any walmart.com or walmart.ca URL: search (/search?q=...), category (/browse/..., /cp/...), brand or filtered search, product (/ip/...), reviews (/reviews/product/...) or seller store (/global/seller/...). Search and category URLs are paginated; filters already in a URL are kept. Example: https://www.walmart.com/search?q=coffee+maker. Default empty.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Search keywords",
            "type": "array",
            "description": "Keywords, one Walmart search each, on the marketplace chosen under Marketplace. Example: air fryer. Default empty.",
            "items": {
              "type": "string"
            }
          },
          "categoryIds": {
            "title": "Category ids",
            "type": "array",
            "description": "Walmart category ids. Top-level departments are a single number (3944 = Electronics); sub-categories need the full path joined with underscores (3944_1060825). A /cp/ or /browse/ URL works here too, and a /cp/ page is resolved to its full path for you. Example: 3944_1060825. Default empty.",
            "items": {
              "type": "string"
            }
          },
          "productIds": {
            "title": "Item ids",
            "type": "array",
            "description": "Walmart item ids (the number at the end of a product URL, e.g. 609040889), the 12-character product id (e.g. 4SZSM8SXAAJT), or product URLs. Example: 609040889. Default empty.",
            "items": {
              "type": "string"
            }
          },
          "domain": {
            "title": "Marketplace",
            "enum": [
              "us",
              "ca"
            ],
            "type": "string",
            "description": "Marketplace used for keywords, category ids and bare item ids. Pasted URLs keep their own site. Values: us, ca. Example: us. Default: us.",
            "default": "us"
          },
          "includeProductDetails": {
            "title": "Open each product page for the full record",
            "type": "boolean",
            "description": "Products mode, for products found by a search or category: fetch every product page for the full record (UPC, model, description, specifications, all images, variants, all seller count, fulfillment options, return policy, star breakdown, review highlights, and the store and ZIP Walmart priced it for). One extra request per product, billed as a product detail. Product URLs and item ids always get the full record. Example: false. Default: false.",
            "default": false
          },
          "sort": {
            "title": "Sort search and category results",
            "enum": [
              "best_match",
              "price_low",
              "price_high",
              "best_seller",
              "rating_high",
              "new"
            ],
            "type": "string",
            "description": "Sort order for keywords, category ids and pasted search or category URLs that do not set their own. Values: best_match, price_low, price_high, best_seller, rating_high, new. Example: best_seller. Default: best_match.",
            "default": "best_match"
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "integer",
            "description": "Only products at or above this price, in the marketplace currency. Applies to searches and categories. Example: 25. Default empty."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "integer",
            "description": "Only products at or below this price, in the marketplace currency. Applies to searches and categories. Example: 200. Default empty."
          },
          "maxPagesPerSearch": {
            "title": "Pages per search or category",
            "minimum": 1,
            "maximum": 25,
            "type": "integer",
            "description": "How many result pages to read per search or category, about 40 products each. Walmart shows at most 25 pages for any query. Range 1-25. Example: 3. Default: 5.",
            "default": 5
          },
          "maxReviewsPerProduct": {
            "title": "Maximum reviews per product",
            "minimum": 0,
            "type": "integer",
            "description": "Reviews mode: stop after this many reviews per product. 0 = every review with text. Example: 50. Default: 100.",
            "default": 100
          },
          "reviewsSort": {
            "title": "Review order",
            "enum": [
              "relevancy",
              "newest",
              "oldest",
              "rating_high",
              "rating_low",
              "helpful"
            ],
            "type": "string",
            "description": "Order in which reviews are read, which decides which ones you get when a cap applies. Values: relevancy, newest, oldest, rating_high, rating_low, helpful. Example: newest. Default: relevancy.",
            "default": "relevancy"
          },
          "reviewRatings": {
            "title": "Star ratings to keep",
            "type": "array",
            "description": "Only reviews with these star ratings; pick several to combine them. Leave empty for all ratings. Values: 1, 2, 3, 4, 5. Example: 1 and 2 for complaints. Default empty.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5"
              ]
            }
          },
          "verifiedPurchasesOnly": {
            "title": "Verified purchases only",
            "type": "boolean",
            "description": "Only reviews Walmart marks as Verified Purchase. Example: true. Default: false.",
            "default": false
          },
          "reviewsNewerThan": {
            "title": "Only reviews since",
            "type": "string",
            "description": "Only reviews submitted on or after this date (YYYY-MM-DD). Reviews are then read newest first and reading stops at the first older one, which makes scheduled runs cheap. Example: 2026-09-01. Default empty."
          },
          "includeSellerDetails": {
            "title": "Add each seller's contact details",
            "type": "boolean",
            "description": "Seller offers mode: open each marketplace seller's store page once and add its public business email, phone, address, rating and review count to that seller's offers. One request per seller, billed once per seller per run. Example: true. Default: false.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum results",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on rows written to the dataset across the whole run: products, reviews, offers or seller profiles. Always set this. Example: 500. Default: 100.",
            "default": 100
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "How many pages are fetched at the same time. Higher is faster; lower is gentler when Walmart is refusing a lot of requests. Range 1-30. Example: 10. Default: 10.",
            "default": 10
          },
          "maxRequestRetries": {
            "title": "Attempts per page",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many times a page is tried, each time from a new IP address, before it is given up. Retries back off over about a minute. Range 1-10. Example: 8. Default: 8.",
            "default": 8
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Walmart refuses datacenter IP addresses, so the actor always goes out through residential addresses in the marketplace's country. Leave this as it is; paste your own proxy URLs only if you want to use your own residential provider."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}