# PadMapper Map Pins

Returns the compact map pins for a map box: one pin per listing or building with coordinates and price. Use it to draw a map, then call listing for detail.

- **Documentation:** [https://scrappa.co/docs/padmapper-api/padmapper_map_pins](https://scrappa.co/docs/padmapper-api/padmapper_map_pins)
- **API group:** PadMapper API
- **Endpoint:** `GET https://scrappa.co/api/padmapper/map-pins`

## 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 |
| --- | --- | --- | --- |
| `min_lat` | number | Yes | Southern edge of the map box. |
| `max_lat` | number | Yes | Northern edge of the map box. |
| `min_lng` | number | Yes | Western edge of the map box. |
| `max_lng` | number | Yes | Eastern edge of the map box. |
| `limit` | integer | No | Pin count, 1 to 500. Default 50. |

## Example response

```json
{
    "data": {
        "pins": [
            {
                "lat": 43.66408935560209,
                "lng": -79.41092795579786,
                "url": "/apartment-buildings/p1113084/mirvish-village-south-annex-toronto-on",
                "city": "Toronto",
                "state": "ON",
                "is_pad": false,
                "pa_url": "748-bathurst-st-toronto-on-m5s-2r6-can",
                "address": "748 Bathurst St",
                "zipcode": "M5S 2R6",
                "external": 0,
                "features": [
                    3,
                    17,
                    18
                ],
                "group_id": -2058520,
                "has_fees": true,
                "feed_name": "llws_mits41_bundle",
                "image_ids": [
                    917895854,
                    921861420,
                    889765019
                ],
                "listed_on": 1792961897,
                "max_price": 4300,
                "min_price": 2030,
                "listing_id": 65223975,
                "building_id": 2058520,
                "modified_on": 1792880146,
                "price_state": 3,
                "max_bedrooms": 3,
                "min_bedrooms": 0,
                "building_name": "Mirvish Village",
                "max_bathrooms": 2,
                "min_bathrooms": 1,
                "is_messageable": true,
                "floorplan_count": 38,
                "max_square_feet": null,
                "min_square_feet": null,
                "neighborhood_name": "South Annex"
            },
            {
                "lat": 43.67535560879889,
                "lng": -79.39352537580052,
                "url": "/apartment-buildings/p638219/30-50-hillsboro-avenue-yorkville-toronto-on",
                "city": "Toronto",
                "state": "ON",
                "is_pad": false,
                "pa_url": "50-ramsden-pl-apts-toronto-on-m5r-1s8-can",
                "address": "50 Ramsden Place Apts.",
                "zipcode": "M5R 1S8",
                "external": 0,
                "features": [
                    3,
                    35,
                    38
                ],
                "group_id": -1837171,
                "has_fees": true,
                "feed_name": "llws_mits41_bundle",
                "image_ids": [
                    891818554,
                    892574503,
                    892574504
                ],
                "listed_on": 1792749607,
                "max_price": 2417,
                "min_price": 1807,
                "listing_id": 61031783,
                "building_id": 1837171,
                "modified_on": 1792767263,
                "price_state": 3,
                "max_bedrooms": 1,
                "min_bedrooms": 0,
                "building_name": "30-50 Hillsboro Avenue",
                "max_bathrooms": 1,
                "min_bathrooms": 1,
                "is_messageable": true,
                "floorplan_count": 4,
                "max_square_feet": null,
                "min_square_feet": null,
                "neighborhood_name": "Yorkville"
            },
            {
                "lat": 43.669018415317055,
                "lng": -79.40489438525988,
                "url": "/apartment-buildings/p219584/50-spadina-road-the-annex-toronto-on",
                "city": "Toronto",
                "state": "ON",
                "is_pad": false,
                "pa_url": "50-spadina-rd-toronto-on-m5r-2p1-can",
                "address": "50 Spadina Rd",
                "zipcode": "M5R 2P1",
                "external": 0,
                "features": [
                    3,
                    38,
                    72
                ],
                "group_id": -1958571,
                "has_fees": false,
                "feed_name": "llws_mits41_bundle",
                "image_ids": [
                    928639213,
                    882575370,
                    882575371
                ],
                "listed_on": 1792947497,
                "max_price": 4318,
                "min_price": 2779,
                "listing_id": 64031212,
                "building_id": 1958571,
                "modified_on": 1792340257,
                "price_state": 3,
                "max_bedrooms": 2,
                "min_bedrooms": 1,
                "building_name": "50 Spadina Road",
                "max_bathrooms": 1,
                "min_bathrooms": 1,
                "is_messageable": true,
                "floorplan_count": 6,
                "max_square_feet": null,
                "min_square_feet": null,
                "neighborhood_name": "The Annex"
            }
        ],
        "matching": 142,
        "commute_times": null
    },
    "meta": {
        "duration_ms": 640,
        "upstream_calls": 1,
        "endpoint_family": "map-pins"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested listing, building, agent, or city was not found. Rent reports exist for US cities only. This response is not billable. |
| 422 | Validation Error | A required public parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result. This response is not billable. |

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