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

# Home Depot Stores

> Returns up to 20 Home Depot stores near a five-digit US ZIP code, ordered by source distance. Preserves four-digit store IDs, name, address, phone, coordinates, store type, distance in miles and seven days of local opening hours. Uses the site's anonymous native store search, not its default-store page cache. This is a bounded nearest-store window, not an exhaustive directory.

Supply a five-digit US ZIP code as `query`, for example `94040` or `10001`. The response contains the native nearest-store window of up to 20 records in increasing source distance order. There is no pagination cursor or exhaustive total. `source_window_full: true` means the 20-record window was filled.

`place.id` is the retailer's four-digit store ID, including leading zeroes such as `0640`. Records include names, native store-page URLs, full addresses, phone numbers, coordinates, `ext.distance_miles`, `ext.store_type` and seven entries in `ext.hours`. Hour strings use local 24-hour time as published by the source; they do not establish current open status, holiday exceptions or live inventory.

The provider calls Home Depot's anonymous native store search from the public locator page with customer credentials omitted. The separately embedded default-store cache is ignored because it can disagree with the requested ZIP. Requests and responses must match the exact source URL and ZIP; malformed or incomplete records fail without a net charge.

Each fresh request costs **1 SocialQuery credit** and uses one basic Firecrawl request within its configured allowance. A source-confirmed missing ZIP returns `404 NOT_FOUND` without a net charge. Cache hits and successful idempotent replays are free. Unsupported filters return validation errors.


## OpenAPI

````yaml GET /home_depot/stores
openapi: 3.1.0
info:
  title: SocialQuery API
  version: '2026-10-09'
  description: >-
    Documented requests for public-source records. Inspect accepted inputs and
    credit amounts, then verify the selected operation before integrating
    preview coverage.
servers:
  - url: https://socialquery.dev/v1
security:
  - apiKey: []
paths:
  /home_depot/stores:
    get:
      tags:
        - Home Depot
      summary: Home Depot Stores
      description: >-
        Returns up to 20 Home Depot stores near a five-digit US ZIP code,
        ordered by source distance. Preserves four-digit store IDs, name,
        address, phone, coordinates, store type, distance in miles and seven
        days of local opening hours. Uses the site's anonymous native store
        search, not its default-store page cache. This is a bounded
        nearest-store window, not an exhaustive directory.
      operationId: get_home_depot_stores
      parameters:
        - name: query
          in: query
          required: true
          example: '95032'
          schema:
            type: string
            pattern: ^[0-9]{5}$
          description: >-
            Five-digit US ZIP code. Leading zeroes are preserved; no city,
            radius or pagination input is supported.
        - name: Cache-Control
          in: header
          required: false
          example: no-cache
          schema:
            type: string
        - name: Idempotency-Key
          in: header
          required: false
          example: 7a5e1b4c-2d8f-4a3b-9c1e-6e8b4d2a1f3c
          schema:
            type: string
        - name: X-Max-Credits
          in: header
          required: false
          description: >-
            Optional nonnegative integer cap on the maximum request hold. A live
            request whose hold exceeds this cap returns 422
            CREDIT_BUDGET_EXCEEDED before spending. Metered holds use the
            requested limit; cache hits and successful idempotent replays cost
            zero.
          schema:
            type: integer
            minimum: 0
      responses:
        '200':
          description: >-
            Returns up to 20 Home Depot stores near a five-digit US ZIP code,
            ordered by source distance. Preserves four-digit store IDs, name,
            address, phone, coordinates, store type, distance in miles and seven
            days of local opening hours. Uses the site's anonymous native store
            search, not its default-store page cache. This is a bounded
            nearest-store window, not an exhaustive directory.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SocialQueryResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          items:
                            type: array
                            maxItems: 20
                            items:
                              type: object
                              properties:
                                place:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    name:
                                      type: string
                                    url:
                                      type: string
                                    category:
                                      type: string
                                    address:
                                      type: string
                                    phone:
                                      type: string
                                    latitude:
                                      type: number
                                    longitude:
                                      type: number
                                    ext:
                                      type: object
                                      properties:
                                        street_address:
                                          type: string
                                        city:
                                          type: string
                                        state:
                                          type: string
                                        postcode:
                                          type: string
                                        country:
                                          const: US
                                        distance_miles:
                                          type: number
                                        store_type:
                                          type: string
                                        hours:
                                          type: array
                                          minItems: 7
                                          maxItems: 7
                                          items:
                                            type: object
                                            properties:
                                              day:
                                                type: string
                                              open:
                                                type: string
                                              close:
                                                type: string
                                            required:
                                              - day
                                              - open
                                              - close
                                      required:
                                        - street_address
                                        - city
                                        - state
                                        - postcode
                                        - country
                                        - distance_miles
                                        - store_type
                                        - hours
                                  required:
                                    - id
                                    - name
                                    - url
                                    - category
                                    - address
                                    - phone
                                    - latitude
                                    - longitude
                                    - ext
                              required:
                                - place
                          returned_count:
                            type: integer
                            minimum: 0
                          query:
                            type: string
                          source:
                            type: string
                          limit:
                            const: 20
                          source_window_full:
                            type: boolean
                          coverage_note:
                            type: string
                        required:
                          - items
                          - returned_count
                          - query
                          - source
                          - limit
                          - source_window_full
                          - coverage_note
        '400':
          $ref: '#/components/responses/Error400'
        '401':
          $ref: '#/components/responses/Error401'
        '402':
          $ref: '#/components/responses/Error402'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        '405':
          $ref: '#/components/responses/Error405'
        '409':
          $ref: '#/components/responses/Error409'
        '422':
          $ref: '#/components/responses/Error422'
        '429':
          $ref: '#/components/responses/Error429'
        '500':
          $ref: '#/components/responses/Error500'
        '502':
          $ref: '#/components/responses/Error502'
        '503':
          $ref: '#/components/responses/Error503'
        '504':
          $ref: '#/components/responses/Error504'
components:
  schemas:
    SocialQueryResponse:
      type: object
      required:
        - success
        - platform
        - endpoint
        - credits_used
        - credits_remaining
        - request_id
        - cached
        - data
      properties:
        success:
          type: boolean
          const: true
        platform:
          type: string
        endpoint:
          type: string
        credits_used:
          type: integer
          minimum: 0
        credits_remaining:
          type:
            - integer
            - 'null'
        request_id:
          type: string
        cached:
          type: boolean
        data:
          type: object
          additionalProperties: true
          description: >-
            The selected operation determines the resource fields in this
            object. Source data can omit a metric or report it as null.
    SocialQueryError:
      type: object
      required:
        - success
        - platform
        - endpoint
        - credits_used
        - credits_remaining
        - request_id
        - cached
        - error
      properties:
        success:
          type: boolean
          const: false
        platform:
          type: string
        endpoint:
          type: string
        credits_used:
          type: integer
          minimum: 0
        credits_remaining:
          type:
            - integer
            - 'null'
        request_id:
          type: string
        cached:
          type: boolean
        error:
          type: object
          required:
            - code
            - type
            - message
            - status
            - doc_url
          properties:
            code:
              type: string
            type:
              type: string
            message:
              type: string
            status:
              type: integer
            doc_url:
              type: string
              format: uri
  responses:
    Error400:
      description: Upstream rejected the request.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error401:
      description: Missing, expired, invalid, or revoked API key.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error402:
      description: Insufficient SocialQuery credits.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error403:
      description: Key scope or provider policy denied access.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error404:
      description: Endpoint or upstream resource not found.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error405:
      description: HTTP method is not supported.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error409:
      description: Idempotency conflict or request in progress.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error422:
      description: Invalid parameters.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error429:
      description: Request limit reached.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error500:
      description: Request processing failed.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error502:
      description: Upstream service failed.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error503:
      description: Provider or required service is unavailable.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
    Error504:
      description: Upstream service timed out.
      headers:
        X-Request-Id:
          schema:
            type: string
        X-Credits-Used:
          schema:
            type: integer
        X-Credits-Remaining:
          schema:
            type: string
        X-Cache:
          schema:
            type: string
            enum:
              - HIT
              - MISS
              - BYPASS
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SocialQueryError'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

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