scraper-api-com Bayut API

Bayut: read-only. 2 public endpoints, no account needed.

Operations 2

GET /v1/bayut/property Get a single Bayut listing with its full detail: description, amenities, all… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/scraper-api-com:scraper-api-com-bayut-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

scraper-api-com-bayut-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: scraper-api.com Bayut API
  version: 0.1.0
  description: 'Self-hosted social media scraping API — a drop-in replacement for scrapecreators.com.


    ## Authentication

    Every request must send your API key in the `x-api-key` header.


    ## Credits

    Billing is credit-based: **1 request = 1 credit** (some endpoints cost more — see each endpoint''s description). Credits are **non-expiring** — buy once, use whenever.


    Response bodies match the ScrapeCreators shapes so existing integrations work unchanged.'
  contact:
    name: Fabian Bitter
    email: fabian@bitter.de
servers:
- url: https://api.scraper-api.com
  description: Production
security:
- apiKeyAuth: []
tags:
- name: Bayut
  description: 'Bayut: read-only. 2 public endpoints, no account needed.'
paths:
  /v1/bayut/search:
    get:
      tags:
      - Bayut
      summary: Search Bayut property listings (UAE) by location, purpose (sale/rent) and…
      operationId: bayut_v1_search
      description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
      security:
      - apiKeyAuth: []
      parameters:
      - name: location
        in: query
        required: false
        description: Free-text place, resolved against Bayut's own location index.
        schema:
          type: string
          example: Dubai Marina
      - name: location_slug
        in: query
        required: false
        description: Exact Bayut location slug; skips the lookup.
        schema:
          type: string
          example: /dubai/dubai-marina
      - name: query
        in: query
        required: false
        description: Full-text query across the listing title and description.
        schema:
          type: string
      - name: purpose
        in: query
        required: false
        description: Sale or rental listings.
        schema:
          type: string
          enum:
          - for-sale
          - for-rent
          example: for-sale
      - name: category
        in: query
        required: false
        description: Category slug of the property type.
        schema:
          type: string
          example: apartments
      - name: price_min
        in: query
        required: false
        schema:
          type: string
      - name: price_max
        in: query
        required: false
        schema:
          type: string
      - name: area_min
        in: query
        required: false
        description: Minimum area in SQUARE METRES (Bayut stores metric, displays sqft).
        schema:
          type: string
      - name: area_max
        in: query
        required: false
        description: Maximum area in SQUARE METRES.
        schema:
          type: string
      - name: rooms_min
        in: query
        required: false
        schema:
          type: string
      - name: rooms_max
        in: query
        required: false
        schema:
          type: string
      - name: baths_min
        in: query
        required: false
        schema:
          type: string
      - name: baths_max
        in: query
        required: false
        schema:
          type: string
      - name: rent_frequency
        in: query
        required: false
        description: Rental period (rentals only).
        schema:
          type: string
          enum:
          - daily
          - weekly
          - monthly
          - yearly
      - name: furnishing
        in: query
        required: false
        description: Furnishing state.
        schema:
          type: string
          enum:
          - furnished
          - unfurnished
          - partly-furnished
      - name: completion_status
        in: query
        required: false
        description: Handover state.
        schema:
          type: string
          enum:
          - completed
          - under-construction
      - name: verified
        in: query
        required: false
        description: Only listings Bayut has verified.
        schema:
          type: string
          enum:
          - 'true'
          - 'false'
      - name: sort
        in: query
        required: false
        description: Sort order.
        schema:
          type: string
          enum:
          - newest
          - price-asc
          - price-desc
          - area-asc
          - area-desc
          - popular
          - verified
          example: newest
      - name: language
        in: query
        required: false
        description: Listing language of the index.
        schema:
          type: string
          enum:
          - en
          - ar
          - ru
          - zh
          example: en
      - name: page
        in: query
        required: false
        schema:
          type: string
      - name: page_size
        in: query
        required: false
        description: Listings per page, 1-50. Default 25.
        schema:
          type: string
      - name: image_width
        in: query
        required: false
        description: Width of the generated photo URLs. Default 1066.
        schema:
          type: string
      - name: image_height
        in: query
        required: false
        description: Height of the generated photo URLs. Default 800.
        schema:
          type: string
      - name: max_images
        in: query
        required: false
        description: Cap on photo URLs per listing. Default 12, 0 for none.
        schema:
          type: string
      responses:
        '200':
          description: Platform-native JSON payload (ScrapeCreators-compatible).
          content:
            application/json:
              example:
                success: true
                query:
                  location: Al Helio
                  location_slug: /ajman/al-helio
                  purpose: for-sale
                  category: null
                  text: null
                  sort: newest
                  language: en
                  index: bayut-production-ads-date-desc-en
                page: 1
                page_size: 25
                total_results: 662479
                number_of_pages: 26500
                has_next_page: true
                count: 1
                results:
                - id: '16092847'
                  title: Luxury VIP Villa for Sale – Al Helio 2, Ajman
                  url: https://www.bayut.com/property/details-16092847.html
                  purpose: for-sale
                  price: 2500000
                  price_hidden: false
                  rent_frequency: null
                  area_sqm: 371.61
                  area_sqft: 4000
                  plot_area_sqm: null
                  rooms: 5
                  baths: 8
                  furnishing_status: unfurnished
                  completion_status: completed
                  is_verified: false
                  reference_number: 102154-z98JAe
                  state: active
                  location:
                    path:
                    - name: UAE
                      slug: /uae
                      id: '5001'
                    - name: Ajman
                      slug: /ajman
                      id: '5385'
                    - name: Al Helio
                      slug: /ajman/al-helio
                      id: '7266'
                    name: Al Helio
                    slug: /ajman/al-helio
                  category:
                    path:
                    - name: Residential
                      slug: residential
                      id: '1'
                    - name: Villas
                      slug: villas
                      id: '3'
                    name: Villas
                    slug: villas
                  geography:
                    lat: 25.390655392167
                    lon: 55.595150565966
                  agency:
                    name: Millionera Properties
                    slug: millionera-properties-102154
                    id: '102154'
                    logo: https://bayut-production.s3.eu-central-1.amazonaws.com/image/355993131/dadddef5864d469c91c55be601189748
                    product: premium
                  contact_name: Wisam Ismail
                  photo_count: 2
                  cover_photo: https://images.bayut.com/thumbnails/857931855-1066x800.jpeg
                  images:
                  - https://images.bayut.com/thumbnails/857931855-1066x800.jpeg
                  - https://images.bayut.com/thumbnails/857931856-1066x800.jpeg
                  created_at: '2026-08-06T09:17:44.000Z'
                  updated_at: '2026-08-06T09:17:45.000Z'
        '400':
          description: Missing or invalid parameters.
          content:
            application/json:
              example:
                error:
                  message: 'Missing required parameter(s): handle'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              example:
                error:
                  message: Invalid API key.
        '402':
          description: Not enough credits.
          content:
            application/json:
              example:
                error:
                  message: Insufficient credits.
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              example:
                error:
                  message: Rate limit exceeded.
        '502':
          description: Upstream scrape failed.
          content:
            application/json:
              example:
                error:
                  message: Upstream scrape failed.
  /v1/bayut/property:
    get:
      tags:
      - Bayut
      summary: 'Get a single Bayut listing with its full detail: description, amenities, all…'
      operationId: bayut_v1_property
      description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
      security:
      - apiKeyAuth: []
      parameters:
      - name: id
        in: query
        required: false
        description: 'Bayut listing id. Provide at least one of: id, url.'
        schema:
          type: string
          example: '16092847'
      - name: url
        in: query
        required: false
        description: 'Any Bayut detail URL. Provide at least one of: id, url.'
        schema:
          type: string
          example: https://www.bayut.com/property/details-16092847.html
      - name: language
        in: query
        required: false
        description: Language of the rendered listing.
        schema:
          type: string
          enum:
          - en
          - ar
          - ru
          - zh
          example: en
      - name: image_width
        in: query
        required: false
        schema:
          type: string
      - name: image_height
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Platform-native JSON payload (ScrapeCreators-compatible).
          content:
            application/json:
              example:
                success: true
                data:
                  id: '16092847'
                  title: Luxury VIP Villa for Sale – Al Helio 2, Ajman
                  url: https://www.bayut.com/property/details-16092847.html
                  purpose: for-sale
                  price: 2500000
                  price_hidden: false
                  rent_frequency: null
                  area_sqm: 371.61
                  area_sqft: 4000
                  plot_area_sqm: null
                  rooms: 5
                  baths: 8
                  furnishing_status: unfurnished
                  completion_status: completed
                  is_verified: false
                  reference_number: 102154-z98JAe
                  state: active
                  location:
                    path:
                    - name: UAE
                      slug: /uae
                      id: '5001'
                    - name: Ajman
                      slug: /ajman
                      id: '5385'
                    - name: Al Helio
                      slug: /ajman/al-helio
                      id: '7266'
                    name: Al Helio
                    slug: /ajman/al-helio
                  category:
                    path:
                    - name: Residential
                      slug: residential
                      id: '1'
                    - name: Villas
                      slug: villas
                      id: '3'
                    name: Villas
                    slug: villas
                  geography:
                    lat: 25.390655392167
                    lon: 55.595150565966
                  agency:
                    name: Millionera Properties
                    slug: millionera-properties-102154
                    id: '102154'
                    logo: https://bayut-production.s3.eu-central-1.amazonaws.com/image/355993131/dadddef5864d469c91c55be601189748
                    product: premium
                  contact_name: Wisam Ismail
                  photo_count: 2
                  cover_photo: https://images.bayut.com/thumbnails/857931855-1066x800.jpeg
                  images:
                  - https://images.bayut.com/thumbnails/857931855-1066x800.jpeg
                  - https://images.bayut.com/thumbnails/857931856-1066x800.jpeg
                  created_at: '2026-08-06T09:17:44.000Z'
                  updated_at: '2026-08-06T09:17:45.000Z'
                  description: 'Luxury VIP Villa for Sale – Al Helio 2, Ajman

                    Prime location near Sheikh Mohammed Bin Zayed Road with freehold ownership for all nationalities.'
                  description_html: Luxury VIP Villa for Sale – Al Helio 2, Ajman<br />Prime location near Sheikh Mohammed Bin Zayed Road with freehold ownership for all nationalities.
                  is_studio: false
                  permit_number: '2279'
                  verification_status: unverified
                  amenities:
                  - group: Features
                    items:
                    - name: Double Glazed Windows
                      slug: double-glazed-windows
                      value: null
                  - group: Building
                    items:
                    - name: Balcony or Terrace
                      slug: balcony-or-terrace
                      value: null
                  photos:
                  - id: 857931855
                    title: 1 WhatsApp_Image_watermarked.jpg
                    url: https://images.bayut.com/thumbnails/857931855-1066x800.jpeg
                  - id: 857931856
                    title: 2 WhatsApp_Image_watermarked.jpg
                    url: https://images.bayut.com/thumbnails/857931856-1066x800.jpeg
                  panorama_count: 0
                  video_count: 0
                  contact:
                    name: Wisam Ismail
                    mobile:
                    - '+971509557734'
                    phone:
                    - '+97165291948'
                    whatsapp: '971545695868'
        '400':
          description: Missing or invalid parameters.
          content:
            application/json:
              example:
                error:
                  message: 'Missing required parameter(s): handle'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              example:
                error:
                  message: Invalid API key.
        '402':
          description: Not enough credits.
          content:
            application/json:
              example:
                error:
                  message: Insufficient credits.
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              example:
                error:
                  message: Rate limit exceeded.
        '502':
          description: Upstream scrape failed.
          content:
            application/json:
              example:
                error:
                  message: Upstream scrape failed.
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your scraper-api.com API key.
x-tagGroups:
- name: Platforms
  tags:
  - Instagram
  - TikTok
  - YouTube
  - Facebook
  - LinkedIn
  - Twitter
  - Spotify
  - Apple Music
  - Kleinanzeigen
  - Quoka
  - markt.de
  - mobile.de
  - '11880'
  - Gelbe Seiten
  - ImmobilienScout24
  - immowelt
  - WG-Gesucht
  - Bayut
  - LOVOO
  - Jaumo
  - Tinder
  - Bumble
  - Snapchat
  - Google
  - Arbeitsagentur
  - Ausbildung.de
  - meinestadt.de