> ## 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 Reviews > Return one page of at most ten Home Depot reviews, sorted most helpful by the source. Date filters apply only to this page and retain undated rows. There is no continuation, complete archive, AI enrichment or reference relevance-ranking parity. Return one page of at most ten Home Depot reviews, sorted most helpful by the source. Date filters apply only to this page and retain undated rows. There is no continuation, complete archive, AI enrichment or reference relevance-ranking parity. Successful uncached requests cost **5 credits**. Cache hits and failed requests cost zero. Provider availability and free allowance may change. ## OpenAPI ````yaml GET /home_depot/reviews 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/reviews: get: tags: - Home Depot summary: Home Depot Reviews description: >- Return one page of at most ten Home Depot reviews, sorted most helpful by the source. Date filters apply only to this page and retain undated rows. There is no continuation, complete archive, AI enrichment or reference relevance-ranking parity. operationId: get_home_depot_reviews parameters: - name: item_id in: query required: true example: '313383605' schema: type: string description: Nine-digit Home Depot product ID. - name: label in: query required: false schema: type: string description: >- AI enrichment is unavailable. Omit this parameter; only judgments=off is accepted. Unsupported enrichment requests fail with 422 and no charge. - name: reports in: query required: false schema: type: string description: >- AI enrichment is unavailable. Omit this parameter; only judgments=off is accepted. Unsupported enrichment requests fail with 422 and no charge. - name: judgments in: query required: false schema: type: string enum: - 'on' - 'off' description: >- AI enrichment is unavailable. Omit this parameter; only judgments=off is accepted. Unsupported enrichment requests fail with 422 and no charge. - name: dry_run in: query required: false schema: type: string enum: - '1' description: >- AI enrichment is unavailable. Omit this parameter; only judgments=off is accepted. Unsupported enrichment requests fail with 422 and no charge. - name: label_evidence in: query required: false schema: type: string enum: - '1' description: >- AI enrichment is unavailable. Omit this parameter; only judgments=off is accepted. Unsupported enrichment requests fail with 422 and no charge. - name: fit in: query required: false schema: type: string enum: - goal description: >- AI enrichment is unavailable. Omit this parameter; only judgments=off is accepted. Unsupported enrichment requests fail with 422 and no charge. - name: goal in: query required: false schema: type: string description: >- AI enrichment is unavailable. Omit this parameter; only judgments=off is accepted. Unsupported enrichment requests fail with 422 and no charge. - name: fit_tokens in: query required: false schema: type: integer description: >- AI enrichment is unavailable. Omit this parameter; only judgments=off is accepted. Unsupported enrichment requests fail with 422 and no charge. - name: since in: query required: false schema: type: string description: >- YYYY-MM-DD or an ISO timestamp with explicit timezone. Filters only the returned source page. Date-only until includes the entire UTC day; undated rows remain. - name: until in: query required: false schema: type: string description: >- YYYY-MM-DD or an ISO timestamp with explicit timezone. Filters only the returned source page. Date-only until includes the entire UTC day; undated rows remain. - 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: >- Return one page of at most ten Home Depot reviews, sorted most helpful by the source. Date filters apply only to this page and retain undated rows. There is no continuation, complete archive, AI enrichment or reference relevance-ranking parity. content: application/json: schema: allOf: - $ref: '#/components/schemas/SocialQueryResponse' - type: object properties: data: type: object properties: items: type: array maxItems: 10 items: type: object properties: review: type: object properties: id: type: - string - 'null' resource_id: type: string text: type: - string - 'null' rating: type: number minimum: 0 maximum: 5 published_at: type: - string - 'null' author: type: object properties: id: type: - string - 'null' display_name: type: - string - 'null' avatar_url: type: - string - 'null' language: type: - string - 'null' verified_purchase: type: - boolean - 'null' helpful_votes: type: - integer - 'null' minimum: 0 photos: type: array items: type: string owner_replies: type: array items: type: object properties: text: type: - string - 'null' author: type: - string - 'null' role: type: - string - 'null' published_at: type: - string - 'null' computed: type: object properties: sentiment: type: 'null' returned_count: type: integer minimum: 0 maximum: 10 source_window_count: type: integer minimum: 0 maximum: 10 source_reported_total: type: - integer - 'null' minimum: 0 total: type: 'null' next_cursor: type: - string - 'null' coverage_note: type: string '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.