# Homely Listing Details API Documentation

Scrappa's `GET /api/homely/listing` returns the full record of one Homely listing. Send the numeric `id` from search.

## What you get

The same fields as a search row, for sale and rental listings alike: the written `description`, `price_text` and `price_numeric`, `bond` and `available_on` for rent, rooms, land and building area, the `address` parts, coordinates, `tags`, `inspections`, all `images`, `floor_plans`, `documents`, `videos`, the `agents` with their public name, phone and email, and the `office` id and name.

## Gaps

Homely publishes the price as text only. There is no fee or rates object: a rental has a `bond` and nothing else. There is no dedicated agent profile, so agents come only with the listing. Image fields are links; the API does not return image files.

## Unknown ids

An id that Homely does not know answers `404` (`not_found`) and is not billed. A listing that was taken down answers the same way. An id that is not a number answers `422`.

- **Documentation:** [https://scrappa.co/docs/homely-api/homely_listing](https://scrappa.co/docs/homely-api/homely_listing)
- **API group:** Homely API
- **Endpoint:** `GET https://scrappa.co/api/homely/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 13634827. |

## Example request

```bash
#!/bin/bash

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

## Example response

```json
{
    "success": true,
    "listing": {
        "id": 13634827,
        "url_slug": "31-eden-street-dudley-park-wa-6210",
        "listing_type": "sale",
        "property_type": "house",
        "status": "available",
        "tier": "basic",
        "is_exclusive": false,
        "title": "Entry-Level Opportunity in Prime Location!",
        "description": "Step into charm, character, and an unbeatable location with this delightful 3-bedroom home.",
        "municipality": null,
        "published_on": "2026-10-26T06:06:46.120Z",
        "last_modified": "2026-10-26T06:07:07.726Z",
        "price_text": "$650,000",
        "price_numeric": 650000,
        "price_period": null,
        "bond": null,
        "listed_on": "2026-10-26T06:06:46.120Z",
        "available_on": null,
        "under_offer": false,
        "sold_price_text": null,
        "sold_on": null,
        "leased_on": null,
        "beds": 3,
        "baths": 1,
        "cars": 3,
        "ensuites": 0,
        "living_areas": 0,
        "open_spaces": 0,
        "toilets": 1,
        "other_features": null,
        "tags": [],
        "area_sqm": 446,
        "building_sqm": 135,
        "is_new_construction": false,
        "address": {
            "full": "31 Eden Street, Dudley Park WA 6210",
            "street_number": "31",
            "unit_number": null,
            "street": "Eden Street",
            "suburb": "Dudley Park",
            "suburb_id": 5717676,
            "state": "WA",
            "postcode": "6210"
        },
        "lat": -32.5401732,
        "lng": 115.7287333,
        "inspections": [
            {
                "starts_on": "2026-10-31T02:00:00.000Z",
                "ends_on": "2026-10-31T02:30:00.000Z"
            }
        ],
        "images": [
            {
                "identifier": "l-VaultRE-13634827-1",
                "version": "5Sa7thaTM3AZqJgYYa7gm4h4pKKKI2zf",
                "url": "https://example.com/photo-1.jpg"
            }
        ],
        "floor_plans": [],
        "documents": [],
        "videos": [],
        "external_links": [],
        "agents": [
            {
                "id": 1077857,
                "name": "Sample Agent",
                "email": "agent@example.com",
                "phone": "(08) 5550 0100",
                "mobile": "0400 000 000"
            }
        ],
        "office": {
            "id": 38010,
            "name": "Sample Realty Mandurah"
        }
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true,
        "attempts": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No listing exists with that id, or it was taken down (`not_found`). Non-billable. |
| 422 | Validation Error | A query parameter is missing, unknown or unusable. Unknown parameters are rejected, never ignored (`request_rejected` is the same failure raised by the source). Non-billable. |
| 503 | Source Unavailable | Homely could not be reached in time, refused the request, or its answer changed shape (`upstream_unavailable`, `request_blocked`, `deadline_exhausted`, `parser_drift`). Retryable and never billed. Clients are never rate limited. |

## 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)