{
  "openapi": "3.0.1",
  "info": {
    "title": "US Grocery Prices: Kroger, Safeway, Publix, H-E-B & More",
    "description": "Compare US grocery prices by store across Kroger banners, Safeway, Albertsons, Publix, H-E-B and Whole Foods. Shelf, catalog and delivery prices, dated deals, unit prices and stock. $0.004 per product: 50 cost $0.20 plus $0.02 start. No login. Public data.",
    "version": "1.0",
    "x-build-id": "fXOPerkUsOxbOZhXR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/vant47~us-grocery-prices-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-vant47-us-grocery-prices-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/vant47~us-grocery-prices-scraper/runs": {
      "post": {
        "operationId": "runs-sync-vant47-us-grocery-prices-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/vant47~us-grocery-prices-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-vant47-us-grocery-prices-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": {
          "retailers": {
            "title": "Retailers",
            "type": "array",
            "description": "Choose kroger, safeway, albertsons, publix, heb or whole-foods. Kroger banners: ralphs, frys, kingsoopers, fredmeyer, smiths, qfc, dillons, marianos, picknsave, harristeeter. Albertsons banners: vons, jewelosco, acme, shaws, starmarket, tomthumb, randalls, pavilions, carrs. Unknown names produce free notes.",
            "default": [
              "kroger",
              "safeway",
              "publix",
              "heb",
              "whole-foods"
            ],
            "items": {
              "type": "string"
            }
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Search each term at every selected store. Leave empty for URL or product monitoring.",
            "items": {
              "type": "string"
            }
          },
          "categoryUrls": {
            "title": "Category URLs",
            "type": "array",
            "description": "Public category URLs. Each is routed only to its selected retailer; accepts the same strings as startUrls.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Category, product or deals URLs",
            "type": "array",
            "description": "Public retailer URLs; automatically routed by domain. URLs never override the chosen store.",
            "items": {
              "type": "string"
            }
          },
          "productIds": {
            "title": "Product IDs",
            "type": "array",
            "description": "With one retailer, bare source IDs. With several, prefix retailer:ID, for example safeway:136010121. Product IDs are not barcodes.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "ZIP codes",
            "type": "array",
            "description": "Common ZIP codes for every retailer. Nonempty locations takes precedence over postalCodes. No supported nearby store produces a free note. No default ZIP is injected.",
            "items": {
              "type": "string"
            }
          },
          "postalCodes": {
            "title": "ZIP codes (alias)",
            "type": "array",
            "description": "Alias for locations; used when locations is empty. Every retailer resolves its own nearest supported store.",
            "items": {
              "type": "string"
            }
          },
          "storeIds": {
            "title": "Exact store IDs",
            "type": "array",
            "description": "Exact store IDs override ZIPs. With several retailers use retailer:ID, for example safeway:3132, heb:92. Bare IDs apply only with a single selected retailer.",
            "items": {
              "type": "string"
            }
          },
          "retailerInputs": {
            "title": "Inputs for individual retailers",
            "type": "object",
            "description": "Optional object keyed by selected retailer. Set searchTerms, locations, postalCodes, storeIds, productIds, categoryUrls or startUrls for each. These override common selections. Use exact stores for repeat monitoring. Remove sample ZIPs when comparing one common ZIP."
          },
          "maxItemsPerRetailer": {
            "title": "Maximum products per retailer",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Total cap for each selected retailer/banner across its terms and stores. Base price $0.004 per qualifying product.",
            "default": 10
          },
          "maxItemsPerSearch": {
            "title": "Maximum products per search and store",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Source cap within each retailer. A source may expose fewer results. The retailer and global caps still apply.",
            "default": 10
          },
          "maxItems": {
            "title": "Maximum products in this run",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Global cap across concurrently collected retailers. 50 products cost $0.20 at base price plus $0.02 start. Set at least the retailer count times the retailer cap to give every retailer its full allowance.",
            "default": 50
          },
          "dealsOnly": {
            "title": "Deals only",
            "type": "boolean",
            "description": "Keep products marked with a source sale or offer. Conditional coupons remain separate from prices.",
            "default": false
          },
          "includeDetails": {
            "title": "Include details",
            "type": "boolean",
            "description": "Optional slower ingredients, nutrition or product metadata where public. No extra result fee.",
            "default": false
          },
          "includeUnpricedProducts": {
            "title": "Include free unpriced catalog rows",
            "type": "boolean",
            "description": "Off by default. Rows with neither a numeric price nor dated promotion are free. They count toward output caps.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Automatic default uses datacenter first and US residential retries. Explicit proxy disable, group, country or custom proxy is preserved.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}