> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapio.dev/llms.txt > Use this file to discover all available pages before exploring further. # Get reviews > Retrieve a property's review score breakdown, and individual review cards on request. ## OpenAPI ````yaml get /v1/booking/reviews openapi: 3.1.0 info: title: Scrapio version: 1.0.0 description: >- Turn any URL into structured data. Fetch raw HTML, crawl sites, extract structured content, interact with dynamic pages, and search the web through one API. contact: name: Scrapio Support url: https://scrapio.dev license: name: Proprietary servers: - url: https://api.scrapio.dev description: Production security: - bearerAuth: [] tags: - name: System - name: Fetch - name: Crawl - name: Map - name: Interact - name: Search - name: Google - name: Fast Search - name: Jobs - name: YouTube - name: Amazon - name: Walmart - name: Booking - name: Agoda - name: Airbnb - name: ChatGPT - name: Perplexity - name: Gemini - name: Bing - name: Reddit - name: TikTok - name: Apple App Store - name: Target - name: Monitors paths: /v1/booking/reviews: get: tags: - Booking summary: Get Booking.com property reviews description: >- Retrieves a Booking.com property's review score breakdown (staff, facilities, cleanliness, and more). By default only the score breakdown is returned; set `include_review_details: true` to click through and return individual review cards too, billed as a separate interact session (25 credits total instead of 15). Requires a Starter plan or higher. operationId: getBookingReviews parameters: - name: property_id in: query required: false schema: description: Booking property slug/id type: string minLength: 1 - name: url in: query required: false schema: description: Full Booking property URL type: string format: uri - name: page in: query required: false schema: description: Review page number (default 1) type: string pattern: ^\d+$ - name: sort_by in: query required: false schema: description: Review sort order type: string minLength: 1 - name: language in: query required: false schema: description: Review language filter (ISO 2-letter code) type: string pattern: ^[A-Za-z]{2}$ - name: include_review_details in: query required: false schema: description: >- Click through to fetch individual review cards (+10 credits, 25 total) type: string enum: - 'true' - 'false' - name: timeout_ms in: query required: false schema: description: Max time to wait, in ms type: string pattern: ^\d+$ responses: '200': description: Booking.com review score breakdown, and review cards when requested. content: application/json: schema: $ref: '#/components/schemas/BookingReviewsResponse' '400': description: Invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '402': description: Plan upgrade required for this tenant. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '502': description: Booking.com blocked the request. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Booking.com execution backend unavailable. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' x-codeSamples: - lang: cURL label: cURL source: >- curl "https://api.scrapio.dev/v1/booking/reviews?property_id=fr/beauvoir&page=1&sort_by=newest" \ -H "Authorization: Bearer $SCRAPIO_API_KEY" components: schemas: BookingReviewsResponse: type: object properties: provider: type: string enum: - booking page_type: type: string enum: - reviews snapshot_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ property_id: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' review_score: anyOf: - type: number - type: 'null' review_count: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' meta_data: type: object properties: page: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 sort_by: anyOf: - type: string - type: 'null' language: anyOf: - type: string - type: 'null' number_of_reviews_returned: type: integer minimum: 0 maximum: 9007199254740991 reviews_source: type: string enum: - plain - click required: - page - sort_by - language - number_of_reviews_returned - reviews_source additionalProperties: false score_breakdown: type: object propertyNames: type: string additionalProperties: type: number reviews: type: array items: type: object properties: title: anyOf: - type: string - type: 'null' score: anyOf: - type: number - type: 'null' positive: anyOf: - type: string - type: 'null' negative: anyOf: - type: string - type: 'null' traveler_type: anyOf: - type: string - type: 'null' room_type: anyOf: - type: string - type: 'null' stay_date: anyOf: - type: string - type: 'null' nationality: anyOf: - type: string - type: 'null' reviewed_at: anyOf: - type: string - type: 'null' required: - title - score - positive - negative - traveler_type - room_type - stay_date - nationality - reviewed_at additionalProperties: false required: - provider - page_type - snapshot_at - property_id - name - review_score - review_count - meta_data - score_breakdown - reviews additionalProperties: false ErrorResponse: type: object properties: request_id: type: string error: type: object properties: code: type: string message: type: string required: - code - message diagnostics: type: object properties: outcome: type: string enum: - failed retryable: type: boolean blocked: type: boolean timed_out: type: boolean required: - outcome - retryable additionalProperties: false required: - request_id - error additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key ````