# Goplaceit Listing Details API Documentation

Scrappa's `GET /api/goplaceit/listing` returns the full record of one Goplaceit property or project. Send the numeric `id` and, for a project, `entity_type=project`.

## What you get

Properties: written `description`, `price`, `price_simulation`, `price_change_percent`, `currency`, `fees` (common expenses), `condition`, region, commune and neighborhood, `latitude` and `longitude`, rooms, built and land area, parking, floor, orientation, `year_built`, `furnished`, `by_owner`, `features` grouped by category, all `images` (url, thumbnail, large), the `agency` and the public `url`.

Projects: `price_from`, ranges for rooms, baths and area, `delivery_date`, `builder`, `architect`, `models` (unit types with area, rooms and floor), features, images and the `agency`.

## Gaps

Phone numbers, email addresses and contact flags are never returned. Fields Goplaceit leaves empty are `null`; a price or area of 0 is `null`. Search rows carry `entity_type`: use it to pick the right lookup. An id that does not exist as that entity type returns 404.

- **Documentation:** [https://scrappa.co/docs/goplaceit-api/goplaceit_listing](https://scrappa.co/docs/goplaceit-api/goplaceit_listing)
- **API group:** Goplaceit API
- **Endpoint:** `GET https://scrappa.co/api/goplaceit/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 | Listing id from search, for example 7452261. |
| `entity_type` | string | No | property (default) or project. Use the entity_type of the search row. |

## Example request

```bash
#!/bin/bash

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

## Example response

```json
{
    "success": true,
    "listing": {
        "id": 7452261,
        "entity_type": "property",
        "title": "en LA CISTERNA",
        "description": "EN VENTA DEPARTAMENTO DE 2 DORMITORIOS EN COMUNA DE LA CISTERNA.",
        "price": 2350,
        "price_simulation": 2350,
        "price_change_percent": null,
        "currency": {
            "id": 2,
            "code": "UF",
            "symbol": "UF",
            "name": "Unidad de Fomento",
            "iso_code": "CLF"
        },
        "mode": "buy",
        "type": "apartment",
        "type_label": "Departamento",
        "condition": {
            "id": 2,
            "name": "Usada"
        },
        "country": "cl",
        "region": {
            "id": 13,
            "name": "Region Metropolitana"
        },
        "commune": {
            "id": 283,
            "name": "La Cisterna"
        },
        "neighborhood": null,
        "latitude": -33.5329121,
        "longitude": -70.6706301,
        "bedrooms": 2,
        "bathrooms": 2,
        "area_m2": 64,
        "land_area_m2": null,
        "parking_spaces": 1,
        "storage_units": null,
        "floor": null,
        "orientation": "Oriente",
        "year_built": 2002,
        "furnished": true,
        "by_owner": null,
        "daily_rental": true,
        "fees": {
            "amount": 70000,
            "currency_id": null
        },
        "extra": [],
        "contact_name": "Sample Agent",
        "source_portal": "Sample Properties",
        "featured": false,
        "created_at": "2026-10-26T01:06:04Z",
        "updated_at": "2026-10-26T01:06:04Z",
        "features": [
            {
                "id": 1,
                "category": "Generales",
                "features": [
                    {
                        "id": 1,
                        "name": "Patio / \u00e1reas verdes comunes",
                        "value": true
                    }
                ]
            }
        ],
        "images": [
            {
                "id": 164326859,
                "url": "https://example.com/photo.jpg",
                "thumbnail": "https://example.com/photo-320x240.jpg",
                "large": "https://example.com/photo-960x720.jpg"
            }
        ],
        "agency": {
            "id": 70429,
            "name": "Sample Properties",
            "type": "Broker",
            "logo": null,
            "description": null,
            "country": "cl"
        },
        "url": "https://www.goplaceit.com/cl/propiedad/venta/departamento/la-cisterna/7452261-en-la-cisterna"
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true,
        "attempts": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No property or project exists with that id for the given entity type (`not_found`). Non-billable. |
| 422 | Validation Error | A query parameter is missing, unknown or unusable. Unknown parameters and unknown sort or type values are rejected, never ignored. Non-billable. |
| 503 | Source Unavailable | Goplaceit 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)