{
  "openapi": "3.0.1",
  "info": {
    "title": "Walmart Product Scraper: Price, Seller, Stock Tracker",
    "description": "Scrape every Walmart.com product of a search or category past the 10-page wall: 6,294 products for coffee maker against 373 in a plain read. Price, seller, stock, rating; UPC and specs by item ID; new-product and price watch.",
    "version": "0.1",
    "x-build-id": "A3Iy2y4J8l0Ckem7t"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/alexmorain~walmart-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-alexmorain-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/alexmorain~walmart-scraper/runs": {
      "post": {
        "operationId": "runs-sync-alexmorain-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/alexmorain~walmart-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-alexmorain-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": {
          "searchQueries": {
            "title": "Search queries",
            "type": "array",
            "description": "Keywords as you would type them on Walmart.com: <code>coffee maker</code>, <code>laptop</code>. Each query returns every product Walmart serves for it, past the 10-page wall.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Walmart URLs",
            "type": "array",
            "description": "Pages copied from walmart.com: a search (<code>/search?q=...</code>, its price range, sort and filters are kept), a category (<code>/browse/...</code> or <code>/cp/...</code>) or a product (<code>/ip/...</code>, read as a product page). Seller pages (<code>/global/seller/...</code>) are not supported: Walmart serves no product list for them.",
            "items": {
              "type": "string"
            }
          },
          "productIds": {
            "title": "Product IDs",
            "type": "array",
            "description": "Walmart item IDs to read one by one, such as <code>985675140</code> (the number at the end of a product URL), or product URLs. Each one returns the full product page (UPC, specifications, variants, seller rating) and is charged as a Detailed product. Meant for pipelines that already hold a list of IDs.",
            "items": {
              "type": "string"
            }
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "integer",
            "description": "In US dollars, whole dollars only (Walmart ignores cents)."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 1,
            "type": "integer",
            "description": "In US dollars, whole dollars only."
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "best_match",
              "price_low",
              "price_high",
              "best_seller",
              "rating_high",
              "new"
            ],
            "type": "string",
            "description": "Walmart's order. It changes which products come first, and with <b>Max items</b> which ones you get.",
            "default": "best_match"
          },
          "seller": {
            "title": "Seller",
            "enum": [
              "any",
              "walmart",
              "proSellers",
              "marketplaceFulfilledByWalmart"
            ],
            "type": "string",
            "description": "<b>Walmart</b>: sold by Walmart.com. <b>Pro sellers</b>: Walmart's Pro Sellers program. <b>Marketplace fulfilled by Walmart</b>: marketplace sellers using Walmart fulfillment. Leave empty for all sellers.",
            "default": "any"
          },
          "customerRating": {
            "title": "Customer rating",
            "enum": [
              "any",
              "4to5",
              "3to3.9"
            ],
            "type": "string",
            "description": "Only products rated 4 to 5 stars, or 3 to 3.9 stars. Leave empty for any rating.",
            "default": "any"
          },
          "inStockOnly": {
            "title": "Available items only",
            "type": "boolean",
            "description": "Hide products Walmart shows as out of stock.",
            "default": false
          },
          "fullCoverage": {
            "title": "Full coverage",
            "type": "boolean",
            "description": "Walmart shows at most 10 pages per search, about 400 unique products, whatever the announced count (5,600 for <code>coffee maker</code>). On, the search is split by price range and sort until each slice fits, so every product is returned and the SUMMARY record shows announced against returned. Off, you get the 10 pages and a note on how many are missing.",
            "default": true
          },
          "includeDetails": {
            "title": "Read each product page",
            "type": "boolean",
            "description": "Adds UPC, model, description, specifications, variants, seller rating and rating breakdown to each product (Detailed product event, higher price).",
            "default": false
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 0,
            "type": "integer",
            "description": "Stops after this many products in total. Empty or 0 = every product Walmart serves for the searches: thousands for a broad query, so set a limit or a maximum charge per run when you test."
          },
          "monitorMode": {
            "title": "Monitoring",
            "enum": [
              "off",
              "newOnly",
              "newAndPriceChanges"
            ],
            "type": "string",
            "description": "<b>New products only</b> returns only products not returned by an earlier run with the same input (and monitor name). <b>New products and price changes</b> also returns products whose price moved, with <code>previousPrice</code> and <code>priceChange</code> (up / down). Walmart picks the store from the IP address and it changes between runs, so a price is only compared with the previous price for the same <code>storeId</code>. Unchanged products are neither returned nor charged. The first run returns everything. State is kept in a store named <code>walmart-scraper-monitor</code> in your account.",
            "default": "off"
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Optional. Runs with the same name and the same input share one memory; change it to start a separate watch on the same search."
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Optional. A JSON summary is POSTed here when the run ends with at least one product. Slack and Discord incoming webhooks work. Redirects are not followed (except 307 / 308)."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}