# Aqarmap Listing API Documentation

Scrappa's `GET /api/aqarmap/listing` returns the full public record of one Aqarmap listing by its numeric `id` from search.

## What you get

Everything search returns, plus `price_per_meter`, the map pin in `latitude` and `longitude`, `video_url`, `brochure`, `meta_title`, `meta_description`, listing `status`, the `compound`, all `amenities` the property type supports in `available_amenities`, mortgage and registration data, the full `payment_plans`, the custom `attributes`, all `translations` and a `seller` block with active listing count, type and score.

## Privacy

Phone and WhatsApp numbers are masked by Aqarmap and are never returned. An unknown or removed `id` returns a non-billable `404`.

- **Documentation:** [https://scrappa.co/docs/aqarmap-api/aqarmap_listing](https://scrappa.co/docs/aqarmap-api/aqarmap_listing)
- **API group:** Aqarmap API
- **Endpoint:** `GET https://scrappa.co/api/aqarmap/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Numeric listing id from search, for example 7360411. |
| `lang` | string | No | en (default) or ar. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/aqarmap/listing?id=7360411"
```

## Example response

```json
{
    "success": true,
    "data": {
        "listing": {
            "id": "7360411",
            "slug": "for-rent-cairo-helwan",
            "url": "https://aqarmap.com.eg/en/listing/7360411/",
            "reference_id": 7360411,
            "title": "Apartment for rent in front of the Japanese Garden, 125 m",
            "description": "Apartment for rent facing the Japanese Garden, 3 bedrooms, 2 bathrooms.",
            "section": {
                "id": 2,
                "key": "rent",
                "title": "For rent"
            },
            "property_type": {
                "id": 1,
                "name": "Apartment",
                "plural_name": "Apartments",
                "slug": "apartment"
            },
            "price": {
                "amount": 10000,
                "currency": "EGP"
            },
            "area": {
                "value": 125,
                "unit": "sqm"
            },
            "address": "Helwan",
            "location": {
                "id": 67,
                "name": "Helwan",
                "slug": "cairo/helwan",
                "full_path": "Greater Cairo / Helwan",
                "type": null,
                "parent": {
                    "id": 1,
                    "name": "Greater Cairo",
                    "slug": "cairo",
                    "full_path": "Greater Cairo",
                    "type": null,
                    "parent": null
                }
            },
            "rooms": 3,
            "baths": 2,
            "floor": 1,
            "year_built": 2020,
            "finish_type": "SUPER_LUX",
            "finish_type_label": "Super lux",
            "amenities": [
                "ELEVATOR",
                "SECURITY"
            ],
            "payment_method": {
                "id": 1,
                "key": "from_owner_cash",
                "label": "From owner cash"
            },
            "payment_plans": [
                {
                    "price": 10000,
                    "down_payment": null,
                    "down_payment_percentage": null,
                    "total_down_payment": 0,
                    "total_remaining_amount": 10000,
                    "over_price": null,
                    "security_deposit": null,
                    "duration": 30
                }
            ],
            "property_view": {
                "id": 1
            },
            "is_price_negotiable": false,
            "is_resale": false,
            "is_primary": false,
            "is_mortgage": false,
            "is_featured": false,
            "main_photo": {
                "id": 47478477,
                "caption": null,
                "order": 1,
                "thumb_url": "https://img-1.aqarmap.com.eg/new-aqarmap-media/search-thumb-webp/2610/6adba8e739dc7555414291.jpg",
                "small_url": "https://img-1.aqarmap.com.eg/new-aqarmap-media/small/2610/6adba8e739dc7555414291.jpg",
                "large_url": "https://img-1.aqarmap.com.eg/new-aqarmap-media/large/2610/6adba8e739dc7555414291.jpg"
            },
            "photos": [],
            "photo_count": 5,
            "published_at": "2026-10-26T01:42:07+03:00",
            "updated_at": "2026-10-26T01:42:07+03:00",
            "latitude": 29.821,
            "longitude": 31.317,
            "featured_type": "not_featured",
            "registration_status": null,
            "mortgage_options": [],
            "seller": {
                "id": 4746422,
                "name": "Al Hoda Real Estate",
                "type": 1,
                "role": 1,
                "active_listings": 4684,
                "score": 4.42,
                "logo": null,
                "personal_photo": null,
                "has_valid_logo": false,
                "has_valid_personal_photo": false
            },
            "price_per_meter": 80,
            "status": {
                "id": 2,
                "key": "live",
                "label": "Live"
            },
            "video_url": null,
            "brochure": null,
            "meta_title": null,
            "meta_description": null,
            "available_amenities": [
                "ELEVATOR",
                "SECURITY",
                "BALCONY"
            ],
            "compound": null,
            "was_featured": false,
            "is_on_hold": false,
            "is_mortgage_approved": null,
            "attributes": [
                {
                    "name": "rooms",
                    "label": "Rooms",
                    "value": "3"
                },
                {
                    "name": "baths",
                    "label": "Baths",
                    "value": "2"
                }
            ],
            "translations": [
                {
                    "locale": "en",
                    "title": "Apartment for rent in Helwan",
                    "description": "Bright apartment.",
                    "address": "Helwan"
                }
            ],
            "parent_listing_id": null
        }
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true,
        "duration_ms": 520
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | Nothing exists with that identifier on Aqarmap (`NOT_FOUND`). Non-billable. |
| 422 | Validation Error | A query parameter is missing, unknown or unusable. Unknown parameters are rejected, never ignored. Non-billable. |
| 503 | Upstream Unavailable | Aqarmap could not be reached after retries, refused the request or answered with a body this API cannot read safely (`UPSTREAM_UNAVAILABLE`). Never billed. Retry when `meta.retryable` is true. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)