> ## 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. ## OpenAPI ````yaml get /v1/agoda/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/agoda/reviews: get: tags: - Agoda summary: Get Agoda property reviews description: >- Retrieves an Agoda property's review score breakdown and individual review cards from a single plain page load — unlike Booking.com, no click-through opt-in is needed. Requires a Starter plan or higher. `page` beyond 1 drives a real capture-and-replay session, billed at 25 credits instead of 15. Real review capture can take longer than this endpoint can safely wait for inline (bounded to keep the request under Cloudflare's edge timeout) — if that budget is exceeded, this returns quickly with an empty `reviews`/`score_breakdown` rather than hanging. For reliable real data, use `GET /v1/agoda/reviews/crawl` instead, which runs the same capture as a background job with no deadline. operationId: getAgodaReviews parameters: - name: property_id in: query required: false schema: description: Agoda numeric property ID type: string minLength: 1 - name: url in: query required: false schema: description: Full Agoda property URL type: string format: uri - name: city_id in: query required: false schema: description: >- Agoda numeric city ID, required alongside property_id when url is not given (see GET /v1/agoda/search's resolved_city_id) type: string pattern: ^\d+$ - 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: timeout_ms in: query required: false schema: description: Max time to wait, in ms type: string pattern: ^\d+$ responses: '200': description: Agoda review score breakdown and review cards. content: application/json: schema: $ref: '#/components/schemas/AgodaReviewsResponse' '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: Agoda blocked the request. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Agoda execution backend unavailable. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' x-codeSamples: - lang: cURL label: cURL source: >- curl "https://api.scrapio.dev/v1/agoda/reviews?property_id=3&city_id=9395&page=1" \ -H "Authorization: Bearer $SCRAPIO_API_KEY" components: schemas: AgodaReviewsResponse: type: object properties: provider: type: string enum: - agoda 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 required: - page - sort_by - language - number_of_reviews_returned 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 ````