> ## 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.

# Scrape Lowe's product search

> Searches Lowe's (lowes.com, US) for `query` at one store and returns `products`: `productId` (Lowe's item id), `itemNumber`, `modelNumber`, `brand`, `title`, `url`, `image`, `rating`, `reviewCount`, `price`, `wasPrice`, `savings`, `savingsPercent` and `saleEnds` (promotions), `clearance`, `minPrice` / `maxPrice` (items with options), `priceType` (store, network = Lowe's online price, sos = special order), `currency`, `availability` (`pickup` with the units on hand at the store, `parcel`, `delivery`, `expeditedDelivery`), `sponsored`, `marketplace`, `bullets` and `specifications`, plus `store` (the store the prices and stock are for) and paging totals. Set the store with `store_id` or `zip` (default: store 1845, Chicago-Brickyard, IL). Results come in Lowe's own order; `free_delivery` keeps free-delivery items only. Start at `page` and collect up to `max_results` across pages (24 per page, each page billed as one request, see `pagesFetched`). A broad keyword Lowe's sends to a category landing page (e.g. patio furniture) is answered from the landing page's first category tile that names the keyword; `category` names it (null for a plain search). A landing page without such a tile answers 404: search a more specific term.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/lowes-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:
  /marketplace/lowes-search:
    post:
      tags:
        - Plugins
      summary: Scrape Lowe's product search
      description: >-
        Searches Lowe's (lowes.com, US) for `query` at one store and returns
        `products`: `productId` (Lowe's item id), `itemNumber`, `modelNumber`,
        `brand`, `title`, `url`, `image`, `rating`, `reviewCount`, `price`,
        `wasPrice`, `savings`, `savingsPercent` and `saleEnds` (promotions),
        `clearance`, `minPrice` / `maxPrice` (items with options), `priceType`
        (store, network = Lowe's online price, sos = special order), `currency`,
        `availability` (`pickup` with the units on hand at the store, `parcel`,
        `delivery`, `expeditedDelivery`), `sponsored`, `marketplace`, `bullets`
        and `specifications`, plus `store` (the store the prices and stock are
        for) and paging totals. Set the store with `store_id` or `zip` (default:
        store 1845, Chicago-Brickyard, IL). Results come in Lowe's own order;
        `free_delivery` keeps free-delivery items only. Start at `page` and
        collect up to `max_results` across pages (24 per page, each page billed
        as one request, see `pagesFetched`). A broad keyword Lowe's sends to a
        category landing page (e.g. patio furniture) is answered from the
        landing page's first category tile that names the keyword; `category`
        names it (null for a plain search). A landing page without such a tile
        answers 404: search a more specific term.
      operationId: lowes_search_marketplace_lowes_search_post
      parameters:
        - name: query
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              What to search, e.g. 'cordless drill', 'garden hose' or 'interior
              paint'.
            title: Query
          description: >-
            What to search, e.g. 'cordless drill', 'garden hose' or 'interior
            paint'.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            description: 1-based results page to start from (1-30, 24 products per page).
            default: 1
            title: Page
          description: 1-based results page to start from (1-30, 24 products per page).
        - name: max_results
          in: query
          required: false
          schema:
            type: integer
            description: >-
              Products to collect across pages (1-72); each page fetched is
              billed as one request.
            default: 24
            title: Max Results
          description: >-
            Products to collect across pages (1-72); each page fetched is billed
            as one request.
        - name: store_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Lowe's store number whose prices and stock to return, e.g. '1845'.
              Give this or `zip`; with neither, store 1845 (Chicago-Brickyard,
              IL) is used. The store used is named in `store`.
            title: Store Id
          description: >-
            Lowe's store number whose prices and stock to return, e.g. '1845'.
            Give this or `zip`; with neither, store 1845 (Chicago-Brickyard, IL)
            is used. The store used is named in `store`.
        - name: zip
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: US ZIP code; the nearest Lowe's store is used, e.g. '60639'.
            title: Zip
          description: US ZIP code; the nearest Lowe's store is used, e.g. '60639'.
        - name: free_delivery
          in: query
          required: false
          schema:
            type: boolean
            description: Only items Lowe's delivers for free.
            default: false
            title: Free Delivery
          description: Only items Lowe's delivers for free.
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Instead of `query`: a Lowe's search link, e.g.
              https://www.lowes.com/search?searchTerm=garden+hose (its offset
              and storeId are used).
            title: Url
          description: >-
            Instead of `query`: a Lowe's search link, e.g.
            https://www.lowes.com/search?searchTerm=garden+hose (its offset and
            storeId are used).
      responses:
        '200':
          description: JSON with a `products` array, paging totals and the store.
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid parameters.
        '404':
          description: >-
            Lowe's found no products, sends the keyword to a category landing
            page without a tile naming it, or no such store / none near `zip`.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by Lowe's on every attempt, no results page returned, or the
            call did not finish 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.