> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Kroger and its banner stores (Ralphs, Fred Meyer, King Soopers, ...)

> Products matching `query` on Kroger or one of its banner sites (`banner`: kroger, ralphs, fredmeyer, kingsoopers, frysfood, smithsfoodanddrug, qfc, dillons, bakersplus, citymarket, gerbes, foodfourless, harristeeter, marianos, metromarket, picknsave, jaycfoods, payless, foodsco), priced for one store. Returns `products` in the site's order with `productId` (Kroger's 13-digit id), `upc`, `gtin14`, `name`, `brand`, `size`, `url`, `image`, `price` (what the shopper pays now), `regularPrice`, `salePrice`, `onSale`, `savings`, `promotion` (`type` sale / price_drop / multibuy / must_buy / bogo, `text`, multibuy `quantity` and `quantityPrice`, `expiresAt`), `unitPrice` (`price`, `unit`, `text`), `soldBy` (unit / weight; weighed items carry Kroger's per-item estimate), `available`, `stockLevel` (HIGH / LOW / TEMPORARILY_OUT_OF_STOCK), `maxOrderQuantity`, `fulfillment` (`pickup`, `delivery`, `inStore`, `ship`: whether the store offers the product that way), `aisle` (`number`, `description`, `side`, `bay`, `shelf`), `rating`, `reviewCount`, `categories`, `snapEligible` and `offers` (extra deals such as 'Save $2 each when you buy 3'), plus `position` and `sponsored`. `totalResults` is the site's total match count; one call returns the first page (up to 24 products). `brand` narrows the search to one or more brands. `store` names the store the prices are for: `storeId`, `name`, `banner`, `address`, `latitude`, `longitude`, `fulfillmentMethods`, `hours`, `pricesFor` (pickup or inStore) and `selectedBy` (store_id / zip / default); with `zip`, `nearbyStores` lists the banner's other stores near it. Prices are in USD and depend on the store. One billed unit per call.



## OpenAPI

````yaml /api-reference/openapi.json post /groceries/kroger-search
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /groceries/kroger-search:
    post:
      tags:
        - Plugins
      summary: >-
        Search Kroger and its banner stores (Ralphs, Fred Meyer, King Soopers,
        ...)
      description: >-
        Products matching `query` on Kroger or one of its banner sites
        (`banner`: kroger, ralphs, fredmeyer, kingsoopers, frysfood,
        smithsfoodanddrug, qfc, dillons, bakersplus, citymarket, gerbes,
        foodfourless, harristeeter, marianos, metromarket, picknsave, jaycfoods,
        payless, foodsco), priced for one store. Returns `products` in the
        site's order with `productId` (Kroger's 13-digit id), `upc`, `gtin14`,
        `name`, `brand`, `size`, `url`, `image`, `price` (what the shopper pays
        now), `regularPrice`, `salePrice`, `onSale`, `savings`, `promotion`
        (`type` sale / price_drop / multibuy / must_buy / bogo, `text`, multibuy
        `quantity` and `quantityPrice`, `expiresAt`), `unitPrice` (`price`,
        `unit`, `text`), `soldBy` (unit / weight; weighed items carry Kroger's
        per-item estimate), `available`, `stockLevel` (HIGH / LOW /
        TEMPORARILY_OUT_OF_STOCK), `maxOrderQuantity`, `fulfillment` (`pickup`,
        `delivery`, `inStore`, `ship`: whether the store offers the product that
        way), `aisle` (`number`, `description`, `side`, `bay`, `shelf`),
        `rating`, `reviewCount`, `categories`, `snapEligible` and `offers`
        (extra deals such as 'Save $2 each when you buy 3'), plus `position` and
        `sponsored`. `totalResults` is the site's total match count; one call
        returns the first page (up to 24 products). `brand` narrows the search
        to one or more brands. `store` names the store the prices are for:
        `storeId`, `name`, `banner`, `address`, `latitude`, `longitude`,
        `fulfillmentMethods`, `hours`, `pricesFor` (pickup or inStore) and
        `selectedBy` (store_id / zip / default); with `zip`, `nearbyStores`
        lists the banner's other stores near it. Prices are in USD and depend on
        the store. One billed unit per call.
      operationId: kroger_search_groceries_kroger_search_post
      parameters:
        - name: query
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: What to search for, e.g. 'milk', 'coca cola', 'gluten free bread'.
            title: Query
          description: What to search for, e.g. 'milk', 'coca cola', 'gluten free bread'.
        - name: banner
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Which Kroger-family store site to use: 'kroger' (Kroger), 'ralphs'
              (Ralphs), 'fredmeyer' (Fred Meyer), 'kingsoopers' (King Soopers),
              'frysfood' (Fry's Food), 'smithsfoodanddrug' (Smith's), 'qfc'
              (QFC), 'dillons' (Dillons), 'bakersplus' (Baker's), 'citymarket'
              (City Market), 'gerbes' (Gerbes), 'foodfourless' (Food 4 Less),
              'harristeeter' (Harris Teeter), 'marianos' (Mariano's),
              'metromarket' (Metro Market), 'picknsave' (Pick 'n Save),
              'jaycfoods' (Jay C Food Stores), 'payless' (Pay Less), 'foodsco'
              (FoodsCo). Host names (ralphs.com) and common spellings
              (food4less, smiths, frys) work too.
            default: kroger
            title: Banner
          description: >-
            Which Kroger-family store site to use: 'kroger' (Kroger), 'ralphs'
            (Ralphs), 'fredmeyer' (Fred Meyer), 'kingsoopers' (King Soopers),
            'frysfood' (Fry's Food), 'smithsfoodanddrug' (Smith's), 'qfc' (QFC),
            'dillons' (Dillons), 'bakersplus' (Baker's), 'citymarket' (City
            Market), 'gerbes' (Gerbes), 'foodfourless' (Food 4 Less),
            'harristeeter' (Harris Teeter), 'marianos' (Mariano's),
            'metromarket' (Metro Market), 'picknsave' (Pick 'n Save),
            'jaycfoods' (Jay C Food Stores), 'payless' (Pay Less), 'foodsco'
            (FoodsCo). Host names (ralphs.com) and common spellings (food4less,
            smiths, frys) work too.
        - name: brand
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Only products of these brands, e.g. 'Kroger' or 'Kroger|Simple
              Truth' (separate several with | or ,).
            title: Brand
          description: >-
            Only products of these brands, e.g. 'Kroger' or 'Kroger|Simple
            Truth' (separate several with | or ,).
        - name: store_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Kroger store id (8 digits, e.g. '01400929'): prices, stock and
              aisles are that store's. The id is shown as `store.storeId` in
              every answer and in `nearbyStores` when you search by `zip`.
            title: Store Id
          description: >-
            Kroger store id (8 digits, e.g. '01400929'): prices, stock and
            aisles are that store's. The id is shown as `store.storeId` in every
            answer and in `nearbyStores` when you search by `zip`.
        - name: zip
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              US ZIP code: prices for the banner's nearest store to it that
              takes online orders (the nearest store at all when none does). The
              answer lists the nearby stores in `nearbyStores`. Leave both
              `store_id` and `zip` blank for the banner's default store.
            title: Zip
          description: >-
            US ZIP code: prices for the banner's nearest store to it that takes
            online orders (the nearest store at all when none does). The answer
            lists the nearby stores in `nearbyStores`. Leave both `store_id` and
            `zip` blank for the banner's default store.
        - name: max_results
          in: query
          required: false
          schema:
            type: integer
            description: Products to return, 1-24 (the first page of results).
            default: 24
            title: Max Results
          description: Products to return, 1-24 (the first page of results).
      responses:
        '200':
          description: >-
            JSON with `store` and `products`. A search with no matches answers
            200 with an empty `products` list.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: >-
            No store of the banner near `zip`, or `store_id` is not a store of
            the banner.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Blocked on every attempt, an unusable answer, or no answer in time.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.