timzinin-com Propertyfinder Gulf API

openapi: 3.2.0
info:
  title: Zinin M2M Hub Propertyfinder Gulf API
  description: Pay-per-call data & tool APIs
  version: 1.0.0
  x-guidance: 'Zinin M2M Hub — pay-per-call data & tool APIs for AI agents. Each POST /api/{slug} operation below is a distinct paid tool: call GET /api/{slug}/schema first for the exact input shape, then POST with a signed PAYMENT-SIGNATURE header (x402 v2, USDC — see x-payment-info per operation) or omit it to receive a 402 with full payment requirements in the PAYMENT-REQUIRED header. The same catalog is also available as MCP JSON-RPC tool bundles at POST /mcp/{bundle} — see GET /.well-known/x402 for the list of bundles.'
tags:
- name: Propertyfinder Gulf
paths:
  /api/propertyfinder-gulf:
    post:
      summary: PropertyFinder.ae UAE Real Estate Listings
      description: Pull live apartment, villa, penthouse and townhouse listings straight from PropertyFinder.ae — the UAE's biggest real-estate portal — by deal type and emirate, sorted freshest-first. No login, no browser, no proxies.
      operationId: call_propertyfinder_gulf
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020000'
        protocols:
        - x402: {}
        network: eip155:8453
        payTo: '0x409D32aD39C02BC9B23a8b2d447532ed801b12dE'
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              title: PropertyFinder.ae Listings input
              type: object
              schemaVersion: 1
              properties:
                deal_type:
                  title: Deal type
                  type: string
                  description: '`sell` for properties for sale, `rent` for properties for rent.'
                  enum:
                  - sell
                  - rent
                  enumTitles:
                  - Sell
                  - Rent
                  default: sell
                  prefill: sell
                emirate:
                  title: Emirate
                  type: string
                  description: Which UAE emirate to search. Each is a sitemap-declared, robots.txt-allowed PropertyFinder.ae page — this Actor does not use the /en/search endpoint (see README FAQ).
                  enum:
                  - dubai
                  - abu-dhabi
                  - sharjah
                  - ajman
                  - ras-al-khaimah
                  - fujairah
                  - umm-al-quwain
                  - al-ain
                  enumTitles:
                  - Dubai
                  - Abu Dhabi
                  - Sharjah
                  - Ajman
                  - Ras Al Khaimah
                  - Fujairah
                  - Umm Al Quwain
                  - Al Ain
                  default: dubai
                  prefill: dubai
                max_items:
                  title: Max results
                  type: integer
                  description: Maximum number of listing rows to return in this run, taken from the freshest candidates collected (see max_listing_age_days).
                  default: 25
                  prefill: 5
                  minimum: 1
                  maximum: 2000
                max_pages:
                  title: Max pages
                  type: integer
                  description: How many result pages to scan (PropertyFinder shows ~20-25 listings per page) before picking the freshest max_items from what was collected.
                  default: 3
                  prefill: 1
                  minimum: 1
                  maximum: 50
                max_listing_age_days:
                  title: Max listing age (days)
                  type: integer
                  description: Optional. Drop any listing whose real posted date is older than this many days. Leave empty to keep the freshest listings regardless of age.
                  minimum: 1
              required: []
      responses:
        '200':
          description: Actor run succeeded and payment settled
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                    description: Actor output items — shape is actor-specific (varies per tool); see this operation's own requestBody schema/description for what the underlying actor produces.
                  meta:
                    type: object
                    properties:
                      run_ms:
                        type: integer
                        description: Actor run duration in milliseconds
                      item_count:
                        type: integer
                        description: len(results)
                      settled:
                        type: boolean
                        description: Whether the x402 payment was confirmed settled by the facilitator
                      transaction:
                        type:
                        - string
                        - 'null'
                        description: On-chain settlement transaction hash, null if unsettled
                    required:
                    - run_ms
                    - item_count
                    - settled
                    - transaction
                required:
                - results
                - meta
        '400':
          description: Malformed PAYMENT-SIGNATURE header or request body
        '402':
          description: Payment required or invalid — see PAYMENT-REQUIRED header
        '409':
          description: Payment payload already used
        '502':
          description: Actor run failed
        '504':
          description: Actor run timed out
      tags:
      - Propertyfinder Gulf