> ## 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. # Yelp Business Reviews > Return up to ten Yelp reviews in source relevance order. The opaque cursor is bound to the business and date filters and advances by ten source rows, even if filtering removes all rows. At most 101 pages are available. Date filters apply to each returned page, not an exhaustive archive; undated rows are retained. Yelp review IDs and unknown sentiment remain null. AI enrichment is unavailable. Return up to ten Yelp reviews in source relevance order. The opaque cursor is bound to the business and date filters and advances by ten source rows, even if filtering removes all rows. At most 101 pages are available. Date filters apply to each returned page, not an exhaustive archive; undated rows are retained. Yelp review IDs and unknown sentiment remain null. AI enrichment is unavailable. Successful uncached requests cost **5 credits**. Cache hits and failed requests cost zero. Provider availability and free allowance may change. ## OpenAPI ````yaml GET /yelp/business/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: /yelp/business/reviews: get: tags: - Yelp summary: Yelp Business Reviews description: >- Return up to ten Yelp reviews in source relevance order. The opaque cursor is bound to the business and date filters and advances by ten source rows, even if filtering removes all rows. At most 101 pages are available. Date filters apply to each returned page, not an exhaustive archive; undated rows are retained. Yelp review IDs and unknown sentiment remain null. AI enrichment is unavailable. operationId: get_yelp_business_reviews parameters: - name: id in: query required: false example: '-4ofMtrD7pSpZIX5pnDkig' schema: type: string description: 22-character Yelp business ID (encid). Aliases are unsupported. - name: url in: query required: false schema: type: string description: >- Canonical HTTPS URL containing the product ID or 22-character Yelp business ID. Query strings, fragments and aliases are unsupported. - name: cursor in: query required: false schema: type: string description: >- Opaque next_cursor from the previous page. Keep business and date filters identical. - 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 up to ten Yelp reviews in source relevance order. The opaque cursor is bound to the business and date filters and advances by ten source rows, even if filtering removes all rows. At most 101 pages are available. Date filters apply to each returned page, not an exhaustive archive; undated rows are retained. Yelp review IDs and unknown sentiment remain null. AI enrichment is unavailable. 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.