{
  "openapi": "3.0.1",
  "info": {
    "title": "Walmart Scraper: Products, Prices, Reviews & Price Tracker",
    "description": "Scrape Walmart products and reviews without login: price, was-price, seller, stock, UPC, specs, every variant with its price, rating breakdown, store aisle, pickup and delivery. From searches, categories, deals, item IDs or links. Price tracking for sellers, brands and price monitoring.",
    "version": "1.0",
    "x-build-id": "zXdx9dNEep16W5hHh"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/panix~walmart-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-panix-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/panix~walmart-scraper/runs": {
      "post": {
        "operationId": "runs-sync-panix-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/panix~walmart-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-panix-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": {
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Words you would type in Walmart's search box (e.g. \"air fryer\"). Each term is its own search. You can also paste walmart.com links here.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Walmart URLs",
            "type": "array",
            "description": "Product links (/ip/...), search links with your own filters and sorting (/search?q=...), category pages (/browse/... or /cp/...), deals and shop pages (/shop/deals), seller pages and review pages (/reviews/product/...). Filters already in a link are kept.",
            "items": {
              "type": "string"
            }
          },
          "itemIds": {
            "title": "Walmart item IDs",
            "type": "array",
            "description": "Walmart item numbers, the number at the end of a product link (walmart.com/ip/.../20877373221). Good for price tracking of a fixed list.",
            "items": {
              "type": "string"
            }
          },
          "maxResultsPerSearch": {
            "title": "Max products per search",
            "minimum": 1,
            "maximum": 1500,
            "type": "integer",
            "description": "Products to deliver for each search term or list link. Walmart shows up to 25 pages of about 40-60 products per search or category.",
            "default": 40
          },
          "maxResults": {
            "title": "Max products in total",
            "minimum": 0,
            "type": "integer",
            "description": "Stop the whole run after this many products (0 = no limit). Reviews are not counted. You can also set a spending limit on the run.",
            "default": 0
          },
          "scrapeProductDetails": {
            "title": "Read product pages",
            "type": "boolean",
            "description": "On: every product's page is read for the seller, stock, UPC, specifications, description, all variants with their own prices, rating breakdown, Walmart's review highlights, pickup and delivery options, store aisle and return policy. Off: only the search-card data (title, price, was-price, rating, reviews, badges, seller, stock), at a much lower price.",
            "default": true
          },
          "sortBy": {
            "title": "Sort search results",
            "enum": [
              "best_match",
              "best_seller",
              "price_low",
              "price_high",
              "rating_high",
              "new"
            ],
            "type": "string",
            "description": "Order of search and category results (links that already have a sort keep it).",
            "default": "best_match"
          },
          "minPrice": {
            "title": "Min price (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Leave out products below this price."
          },
          "maxPrice": {
            "title": "Max price (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Leave out products above this price."
          },
          "minRating": {
            "title": "Min star rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Leave out products rated below this (e.g. 4 or 4.5)."
          },
          "minReviews": {
            "title": "Min number of reviews",
            "minimum": 0,
            "type": "integer",
            "description": "Leave out products with fewer reviews than this."
          },
          "onlySoldByWalmart": {
            "title": "Only sold by Walmart",
            "type": "boolean",
            "description": "Only products sold by Walmart.com itself, not by marketplace sellers.",
            "default": false
          },
          "onlyInStock": {
            "title": "Only in stock",
            "type": "boolean",
            "description": "Leave out products Walmart shows as out of stock.",
            "default": false
          },
          "includeSponsored": {
            "title": "Include sponsored results",
            "type": "boolean",
            "description": "Also deliver paid placements from search results (marked isSponsored). Walmart mixes them into every page; turn this off for organic results only.",
            "default": true
          },
          "maxReviewsPerProduct": {
            "title": "Reviews per product",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Also deliver up to this many customer reviews for every product (one row per review, after its product). 0 = no reviews. Review page links (/reviews/product/...) deliver 100 reviews when this is 0.",
            "default": 0
          },
          "reviewsSort": {
            "title": "Review order",
            "enum": [
              "newest",
              "most_helpful",
              "relevancy",
              "oldest",
              "highest_rating",
              "lowest_rating"
            ],
            "type": "string",
            "description": "Which reviews come first.",
            "default": "newest"
          },
          "reviewsRatings": {
            "title": "Only these star ratings",
            "type": "array",
            "description": "Only reviews with these stars, e.g. [\"1\", \"2\"] for complaints. Empty = all ratings.",
            "items": {
              "type": "string",
              "enum": [
                "5",
                "4",
                "3",
                "2",
                "1"
              ],
              "enumTitles": [
                "5 stars",
                "4 stars",
                "3 stars",
                "2 stars",
                "1 star"
              ]
            }
          },
          "reviewsVerifiedOnly": {
            "title": "Only verified purchases",
            "type": "boolean",
            "description": "Only reviews from customers Walmart verified as buyers.",
            "default": false
          },
          "trackChanges": {
            "title": "Track price and stock changes",
            "type": "boolean",
            "description": "Compare every product with the last run that used the same tracker name and add a changes field: price before and after, change in %, stock, rating, review count and seller before.",
            "default": false
          },
          "onlyChangedProducts": {
            "title": "Only changed products",
            "type": "boolean",
            "description": "With tracking: deliver only products whose price, stock or seller changed since the last run (plus products seen for the first time). Unchanged products are left out and not charged.",
            "default": false
          },
          "monitorName": {
            "title": "Tracker name",
            "type": "string",
            "description": "Name of the memory used by change tracking. Use a different name for each schedule or product list.",
            "default": "default"
          },
          "maxConcurrency": {
            "title": "Parallel pages",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Walmart pages read at the same time.",
            "default": 10
          },
          "useResidentialFallback": {
            "title": "Retry blocked pages on residential IPs",
            "type": "boolean",
            "description": "When Walmart's bot check blocks a page several times on the main proxy, retry it on US residential IPs (included in the price).",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify datacenter proxy works for Walmart's public pages and is the default.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}