# Metrocuadrado Project API Documentation

Scrappa's `GET /api/metrocuadrado/project` endpoint returns the sibling units of a new development. New-build inventory shows up in search as a handful of project entries; this endpoint expands one of them into the units actually for sale, which is how you enumerate a development's full stock from the search results.

Pass the id of any unit as `project_code` — for example `17004-C0001-10`. The source resolves the project from that id and returns the remaining units with their price, area, room counts and links.

Contact details published on a unit are removed before the response is returned. A project code with no sibling units returns a non-billable error rather than an empty success.

- **Documentation:** [https://scrappa.co/docs/metrocuadrado-api/metrocuadrado_project](https://scrappa.co/docs/metrocuadrado-api/metrocuadrado_project)
- **API group:** Metrocuadrado API
- **Endpoint:** `GET https://scrappa.co/api/metrocuadrado/project`

## 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 |
| --- | --- | --- | --- |
| `project_code` | string | Yes | Id of any unit in the development, for example 17004-C0001-10. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/metrocuadrado/project?project_code=17004-C0001-10"
```

## Example response

```json
{
    "success": true,
    "project_code": "17004-C0001-10",
    "returned": 1,
    "units": [
        {
            "id": "17004-C0001-11",
            "title": "Apartamento en proyecto, torre 1",
            "url": "https://www.metrocuadrado.com/inmueble/apartamento-en-venta/proyecto-torre-1/17004-C0001-11",
            "image": "https://multimedia.metrocuadrado.com/17004-C0001-11/17004-C0001-11_1_p.jpg",
            "price_sale": 890000000,
            "price_lease": null,
            "area_m2": 95,
            "bedrooms": 3,
            "bathrooms": 3,
            "garages": 2,
            "status": "nuevo"
        }
    ],
    "meta": {
        "endpoint_family": "project"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Error | The project code is missing or malformed. Nothing is charged. |
| 404 | Error | No sibling units exist for this project code. Not charged. |
| 503 | Error | The source was unreachable. Not charged, safe to retry. |

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