> ## Documentation Index > Fetch the complete documentation index at: https://realtycrawl.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Search agencies > One source-classified Property Finder Dubai agency directory card, using propertyfinder/AE/source_region dubai-directory and explicit limit1. No query, cursor or other filters. Contacts, staff, license/reputation and exact locations omitted. Retained in the same account24h. Success50 credits; failures/replay zero. Property Finder UAE supports the dubai-directory source window, one platform propertyfinder, country AE and explicit limit=1. Query, cursor and extra filters are unsupported. Success costs50 credits; failures and replay cost0. ```json theme={null} { "platforms": [ "propertyfinder" ], "location": { "kind": "source_region", "platform": "propertyfinder", "country": "AE", "region_id": "dubai-directory" }, "limit": 1 } ``` The source-classified directory card is retained privately in this account for24 hours. Contacts, demographics, licenses, ratings, staff and exact location are omitted. Source update time and completeness remain unknown. Use the returned ID for the retained read and separately supported residential sale portfolio route. See [coverage](/docs/coverage) and [live capabilities](https://realtycrawl.dev/v1/meta/capabilities). ## OpenAPI ````yaml POST /v1/agencies/search openapi: 3.1.0 info: title: RealtyCrawl proposed unified API version: 0.1.0 description: >- Research draft dated 2026-10-13. No production server or enabled platform coverage is implied. Country and operation capabilities must be checked. servers: - url: https://realtycrawl.dev security: - ApiKeyAuth: [] paths: /v1/agencies/search: post: tags: - agencies summary: Search agencies description: >- One source-classified Property Finder Dubai agency directory card, using propertyfinder/AE/source_region dubai-directory and explicit limit1. No query, cursor or other filters. Contacts, staff, license/reputation and exact locations omitted. Retained in the same account24h. Success50 credits; failures/replay zero. operationId: searchAgencies requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AgencySearchRequest' responses: '200': description: Successful response; meta discloses source completeness content: application/json: schema: $ref: '#/components/schemas/searchAgenciesResponse' default: description: Typed error response content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: AgencySearchRequest: type: object properties: platforms: type: array items: type: string minItems: 1 maxItems: 1 query: type: string location: $ref: '#/components/schemas/LocationSelector' limit: type: integer minimum: 1 maximum: 1 default: 1 cursor: type: string required: - platforms - location - limit additionalProperties: false searchAgenciesResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/Agency' meta: $ref: '#/components/schemas/Meta' required: - data - meta additionalProperties: false ErrorResponse: type: object properties: error: type: object properties: code: type: string message: type: string retryable: type: boolean details: type: array items: $ref: '#/components/schemas/SourceOutcome' required: - code - message - retryable additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false LocationSelector: oneOf: - type: object properties: kind: const: text query: type: string country: type: string required: - kind - query - country additionalProperties: false - type: object properties: kind: const: postal_code postal_code: type: string country: type: string required: - kind - postal_code - country additionalProperties: false - type: object properties: kind: const: bbox bbox: type: array items: type: number minItems: 4 maxItems: 4 required: - kind - bbox additionalProperties: false description: >- west,south,east,north in WGS84; bounds and antimeridian handling validated at runtime. - type: object properties: kind: const: radius latitude: type: number minimum: -90 maximum: 90 longitude: type: number minimum: -180 maximum: 180 radius_meters: type: number exclusiveMinimum: 0 maximum: 100000 required: - kind - latitude - longitude - radius_meters additionalProperties: false - type: object properties: kind: const: polygon geometry: type: object properties: type: const: Polygon coordinates: type: array items: type: array minItems: 4 items: type: array items: type: number minItems: 2 maxItems: 2 required: - type - coordinates additionalProperties: false required: - kind - geometry additionalProperties: false description: >- GeoJSON WGS84 polygon with closed rings. Ring closure and coordinate bounds validated at runtime. - type: object properties: kind: const: source_region platform: type: string region_id: type: string country: type: string required: - kind - platform - region_id - country additionalProperties: false Agency: type: object properties: id: type: string source: $ref: '#/components/schemas/Source' name: anyOf: - type: string - type: 'null' address: anyOf: - $ref: '#/components/schemas/Address' - type: 'null' website: anyOf: - type: string - type: 'null' required: - id - source additionalProperties: false Meta: type: object properties: request_id: type: string schema_version: type: string generated_at: type: string format: date-time completeness: type: string enum: - complete - partial - unknown sources: type: array items: $ref: '#/components/schemas/SourceOutcome' warnings: type: array items: type: object properties: code: type: string message: type: string field: type: string required: - code - message additionalProperties: false pagination: type: object properties: next_cursor: anyOf: - type: string - type: 'null' has_more: type: boolean returned: type: integer total: anyOf: - type: integer - type: 'null' total_relation: type: string enum: - exact - lower_bound - unknown required: - next_cursor - has_more - returned - total - total_relation additionalProperties: false property_groups: type: array items: $ref: '#/components/schemas/PropertyGroup' required: - request_id - schema_version - generated_at - completeness - sources additionalProperties: false SourceOutcome: type: object properties: platform: type: string provider: anyOf: - type: string - type: 'null' status: type: string enum: - success - partial - failed - unsupported error_code: anyOf: - type: string - type: 'null' truncated: type: boolean observed_at: anyOf: - type: string format: date-time - type: 'null' required: - platform - status additionalProperties: false Source: type: object properties: platform: type: string country: type: string native_id: anyOf: - type: string - type: 'null' url: anyOf: - type: string format: uri - type: 'null' provider: type: string observed_at: type: string format: date-time source_updated_at: anyOf: - type: string format: date-time - type: 'null' access_class: type: string enum: - public_portal - licensed_feed - public_record - modeled retrieved_at: type: string format: date-time required: - platform - provider - observed_at - access_class additionalProperties: false Address: type: object properties: formatted: anyOf: - type: string - type: 'null' line1: anyOf: - type: string - type: 'null' unit: anyOf: - type: string - type: 'null' city: anyOf: - type: string - type: 'null' region: anyOf: - type: string - type: 'null' postal_code: anyOf: - type: string - type: 'null' country: type: string pattern: ^[A-Z]{2}$ original_text: anyOf: - type: string - type: 'null' required: - country additionalProperties: false PropertyGroup: type: object properties: property_id: anyOf: - type: string - type: 'null' listing_ids: type: array items: type: string match_method: type: string confidence: anyOf: - type: number - type: 'null' status: type: string enum: - matched - ambiguous required: - property_id - listing_ids - match_method - status additionalProperties: false securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.