> ## 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. # Search hotel availability > Search Booking.com for a destination and stay window, returning structured property results. ## OpenAPI ````yaml get /v1/booking/search 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/search: get: tags: - Booking summary: Search Booking.com hotels description: >- Searches Booking.com hotel availability for a destination and stay window, returning structured property results (price, stars, review score, coordinates, and more). Requires a Starter plan or higher. `pos_country` pins the point-of-sale market by routing through a residential proxy in that country, since Booking's prices vary by point of sale. operationId: searchBooking parameters: - name: location in: query required: true schema: type: string minLength: 1 description: Destination text or lat,lng - name: check_in in: query required: true schema: description: Check-in date (YYYY-MM-DD) type: string pattern: ^\d{4}-\d{2}-\d{2}$ - name: check_out in: query required: true schema: description: Check-out date (YYYY-MM-DD) type: string pattern: ^\d{4}-\d{2}-\d{2}$ - name: adults in: query required: false schema: description: Number of adults (default 2) type: string pattern: ^\d+$ - name: children in: query required: false schema: description: Number of children (default 0) type: string pattern: ^\d+$ - name: children_ages in: query required: false schema: description: Comma-separated child ages; length must match children type: string pattern: ^\d+(,\d+)*$ - name: rooms in: query required: false schema: description: Number of rooms (default 1) type: string pattern: ^\d+$ - name: currency in: query required: false schema: description: Display currency (ISO 4217) type: string pattern: ^[A-Za-z]{3}$ - name: pos_country in: query required: false schema: description: Point-of-sale market (ISO country code) type: string pattern: ^[A-Za-z]{2}$ - name: device in: query required: false schema: type: string enum: - desktop - mobile - tablet description: Device profile to emulate - name: sort_by in: query required: false schema: description: Sort order for results type: string minLength: 1 - name: min_price in: query required: false schema: description: Minimum per-night price type: string pattern: ^\d+$ - name: max_price in: query required: false schema: description: Maximum per-night price type: string pattern: ^\d+$ - name: stars in: query required: false schema: description: Comma-separated star ratings to include type: string pattern: ^[1-5](,[1-5])*$ - name: min_review_score in: query required: false schema: description: Minimum review score, 1-10 type: string pattern: ^(10(\.0)?|\d(\.\d)?)$ - name: page in: query required: false schema: description: Result page number type: string pattern: ^\d+$ - name: pages in: query required: false schema: description: Number of pages to fetch, max 5 type: string pattern: ^\d+$ - name: timeout_ms in: query required: false schema: description: Max time to wait, in ms type: string pattern: ^\d+$ responses: '200': description: Structured Booking.com search results. content: application/json: schema: $ref: '#/components/schemas/BookingSearchResponse' '400': description: Invalid search 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/search?location=Paris&check_in=2026-08-10&check_out=2026-08-12&adults=2&rooms=1¤cy=EUR&pos_country=fr" \ -H "Authorization: Bearer $SCRAPIO_API_KEY" components: schemas: BookingSearchResponse: type: object properties: provider: type: string enum: - booking page_type: type: string enum: - search 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))$ meta_data: type: object properties: url: type: string format: uri location: anyOf: - type: string - type: 'null' resolved_coordinates: anyOf: - type: object properties: lat: type: number lng: type: number required: - lat - lng additionalProperties: false - type: 'null' start_page: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 page: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 end_page: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 pages_requested: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 pages_returned: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 number_of_results: anyOf: - type: number - type: 'null' number_of_properties: type: integer minimum: 0 maximum: 9007199254740991 required: - url - location - resolved_coordinates - start_page - end_page - pages_requested - pages_returned - number_of_results - number_of_properties additionalProperties: false stay: type: object properties: check_in: type: string check_out: type: string nights: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - check_in - check_out - nights additionalProperties: false occupancy: type: object properties: adults: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 children: type: integer minimum: 0 maximum: 9007199254740991 children_ages: type: array items: type: integer minimum: 0 maximum: 9007199254740991 rooms: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - adults - children - children_ages - rooms additionalProperties: false currency: anyOf: - type: string - type: 'null' pos_country: anyOf: - type: string - type: 'null' properties: type: array items: type: object properties: position: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 property_id: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' type: anyOf: - type: string - type: 'null' stars: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' review_score: anyOf: - type: number - type: 'null' review_count: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' review_label: anyOf: - type: string - type: 'null' price: type: object properties: amount: anyOf: - type: number - type: 'null' currency: anyOf: - type: string - type: 'null' nights: anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' per_night: anyOf: - type: number - type: 'null' taxes_included: anyOf: - type: boolean - type: 'null' display: anyOf: - type: string - type: 'null' required: - amount - currency - nights - per_night - taxes_included - display additionalProperties: false free_cancellation: anyOf: - type: boolean - type: 'null' address: anyOf: - type: string - type: 'null' coordinates: anyOf: - type: object properties: lat: type: number lng: type: number required: - lat - lng additionalProperties: false - type: 'null' thumbnail: anyOf: - type: string - type: 'null' url: type: string format: uri required: - position - property_id - name - type - stars - review_score - review_count - review_label - price - free_cancellation - address - coordinates - thumbnail - url additionalProperties: false applied_filters: type: object properties: sort_by: anyOf: - type: string - type: 'null' min_price: anyOf: - type: number - type: 'null' max_price: anyOf: - type: number - type: 'null' stars: type: array items: type: integer minimum: -9007199254740991 maximum: 9007199254740991 min_review_score: anyOf: - type: number - type: 'null' required: - sort_by - min_price - max_price - stars - min_review_score additionalProperties: false required: - provider - page_type - snapshot_at - meta_data - stay - occupancy - currency - pos_country - properties - applied_filters 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 ````