# PadMapper Listing

Returns one listing with rent, beds, baths, the full description, amenity tags and groups, lease terms, fees and deposits, pet policy, media, location, and listing agents. image_urls holds ready image links. Agent email is never returned.

- **Documentation:** [https://scrappa.co/docs/padmapper-api/padmapper_listing](https://scrappa.co/docs/padmapper-api/padmapper_listing)
- **API group:** PadMapper API
- **Endpoint:** `GET https://scrappa.co/api/padmapper/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 |
| --- | --- | --- | --- |
| `listing_id` | string | Yes | Listing id from search results. |

## Example response

```json
{
    "data": {
        "url": "/buildings/p1113084/mirvish-village-apartments-at-748-bathurst-st-toronto-on-m5s-2r6",
        "fees": [
            {
                "name": "Deposit",
                "tier": null,
                "type": 3,
                "count": null,
                "cadence": 0,
                "species": null,
                "is_fixed": null,
                "cost_type": 1,
                "group_key": null,
                "lifecycle": 2,
                "is_derived": null,
                "refundable": null,
                "description": null,
                "is_required": true,
                "requirement": 1,
                "max_in_cents": null,
                "min_in_cents": 0,
                "refundability": null,
                "amount_in_cents": 0
            }
        ],
        "pets": [
            2,
            3,
            1
        ],
        "hours": null,
        "media": [
            {
                "name": "",
                "width": 1829,
                "height": 2615,
                "media_id": 925458611,
                "media_type": 2,
                "is_available": true,
                "process_state": 8
            }
        ],
        "pb_id": 1113084,
        "phone": null,
        "pl_id": null,
        "price": 3375,
        "title": "589 Jr 2 Bedroom 2 Bathroom C3",
        "is_pad": false,
        "is_pro": false,
        "pa_url": "748-bathurst-st-toronto-on-m5s-2r6-can",
        "pb_url": "mirvish-village-south-annex-toronto-on",
        "pl_url": null,
        "prices": [
            [
                1788179672,
                3375,
                3375
            ]
        ],
        "address": "748 Bathurst St",
        "similar": null,
        "bedrooms": 2,
        "deposits": null,
        "external": 0,
        "features": [
            22,
            23,
            20
        ],
        "has_fees": true,
        "viewings": null,
        "zappable": 0,
        "amenities": [
            16,
            2,
            7
        ],
        "bathrooms": 2,
        "feed_name": "llws_mits41_bundle",
        "listed_on": 1792677601,
        "max_price": 3375,
        "min_price": 3375,
        "unit_data": {
            "active": 1,
            "max_price": 3375,
            "min_price": 3375,
            "max_square_feet": 865,
            "min_square_feet": 865
        },
        "city_state": "toronto-on",
        "created_on": 1788179671,
        "fee_uplift": null,
        "image_urls": [
            "https://img.zumpercdn.com/925458611/1280x960"
        ],
        "lease_type": 1,
        "listing_id": 65223975,
        "pet_policy": null,
        "attribution": null,
        "building_id": 2058520,
        "description": "",
        "is_featured": true,
        "lease_terms": null,
        "leasing_fee": null,
        "modified_on": 1792815632,
        "parsed_data": [],
        "price_state": 3,
        "provider_id": "llws_mits41_bundle.314895.f-id-314895-1588832",
        "square_feet": 865,
        "active_units": null,
        "amenity_tags": [
            "Air Conditioning",
            "Dishwasher",
            "Balcony"
        ],
        "brokerage_id": 1212064,
        "listing_type": 1,
        "neighborhood": {
            "box": [
                -79.4256539,
                43.654359,
                -79.4000735
            ],
            "lat": 43.660222,
            "lng": -79.412723,
            "url": "/apartments/toronto-on/south-annex",
            "city": "Toronto",
            "name": "South Annex",
            "path": "toronto-on/south-annex",
            "type": 1,
            "index": true,
            "state": "ON",
            "city_id": 3191,
            "country": "CAN",
            "list_url": "/apartments/toronto-on/south-annex",
            "parent_id": null,
            "index_attrs": null,
            "listing_count": 86,
            "main_image_url": null,
            "city_state_name": "toronto-on/south-annex",
            "latest_ppb_json": [
                2332,
                2527,
                3300,
                4100,
                4850
            ],
            "neighborhood_id": 43819,
            "index_attrs_json": null
        },
        "price_change": 0,
        "provider_url": null,
        "building_name": "Mirvish Village",
        "currency_code": 2,
        "feed_sub_name": null,
        "property_type": 4,
        "amenity_groups": {
            "View": {
                "group": 2,
                "level": 2,
                "parent_display": null
            },
            "Patio": {
                "group": 2,
                "level": 2,
                "parent_display": null
            },
            "Balcony": {
                "group": 2,
                "level": 2,
                "parent_display": null
            },
            "Elevator": {
                "group": 3,
                "level": 1,
                "parent_display": null
            },
            "Microwave": {
                "group": 1,
                "level": 2,
                "parent_display": null
            },
            "Recycling": {
                "group": 5,
                "level": 1,
                "parent_display": null
            },
            "Roof Deck": {
                "group": 3,
                "level": 1,
                "parent_display": null
            },
            "Bike Racks": {
                "group": 4,
                "level": 1,
                "parent_display": null
            },
            "Dishwasher": {
                "group": 1,
                "level": 2,
                "parent_display": null
            },
            "Media Room": {
                "group": 3,
                "level": 1,
                "parent_display": null
            },
            "Playground": {
                "group": 4,
                "level": 1,
                "parent_display": null
            },
            "Cable Ready": {
                "group": 7,
                "level": 2,
                "parent_display": null
            },
            "Spa/Hot Tub": {
                "group": 4,
                "level": 1,
                "parent_display": null
            },
            "Free Weights": {
                "group": 3,
                "level": 1,
                "parent_display": null
            },
            "Night Patrol": {
                "group": 5,
                "level": 1,
                "parent_display": null
            },
            "Refrigerator": {
                "group": 1,
                "level": 2,
                "parent_display": null
            },
            "Outdoor Space": {
                "group": 4,
                "level": 1,
                "parent_display": null
            },
            "Swimming Pool": {
                "group": 4,
                "level": 1,
                "parent_display": null
            },
            "Fitness Center": {
                "group": 3,
                "level": 1,
                "parent_display": null
            },
            "Garage Parking": {
                "group": 4,
                "level": 1,
                "parent_display": null
            },
            "Business Center": {
                "group": 3,
                "level": 1,
                "parent_display": null
            },
            "In-Unit Laundry": {
                "group": 1,
                "level": 2,
                "parent_display": null
            },
            "Package Service": {
                "group": 5,
                "level": 1,
                "parent_display": null
            },
            "Recreation Room": {
                "group": 3,
                "level": 1,
                "parent_display": null
            },
            "Air Conditioning": {
                "group": 2,
                "level": 2,
                "parent_display": null
            },
            "Garbage Disposal": {
                "group": 1,
                "level": 1,
                "parent_display": null
            },
            "Washer and Dryer": {
                "group": 1,
                "level": 2,
                "parent_display": null
            },
            "Window Coverings": {
                "group": 2,
                "level": 2,
                "parent_display": null
            },
            "Historic Building": {
                "group": 3,
                "level": 1,
                "parent_display": null
            },
            "Off-Street Parking": {
                "group": 4,
                "level": 1,
                "parent_display": null
            },
            "On-Site Management": {
                "group": 5,
                "level": 1,
                "parent_display": null
            },
            "High-Speed Internet": {
                "group": 7,
                "level": 2,
                "parent_display": null
            },
            "On-Site Maintenance": {
                "group": 5,
                "level": 1,
                "parent_display": null
            },
            "Barbecue/Picnic Area": {
                "group": 4,
                "level": 1,
                "parent_display": null
            },
            "Efficient Appliances": {
                "group": 1,
                "level": 2,
                "parent_display": null
            },
            "Electronic Thermostat": {
                "group": 7,
                "level": 2,
                "parent_display": null
            },
            "Public Transportation": {
                "group": 6,
                "level": 1,
                "parent_display": null
            },
            "Wheelchair Accessible": {
                "group": 3,
                "level": 1,
                "parent_display": null
            }
        },
        "base_max_price": 3375,
        "base_min_price": 3375,
        "date_available": null,
        "freemium_score": null,
        "half_bathrooms": 0,
        "is_messageable": true,
        "listing_agents": [],
        "listing_status": 1,
        "max_lease_days": 365,
        "min_lease_days": 365,
        "mls_listing_id": null,
        "promotion_type": 5,
        "pa_should_index": false,
        "listing_location": {
            "tz": "America/Toronto",
            "lat": 43.66408935560209,
            "lng": -79.41092795579786,
            "city": "Toronto",
            "unit": null,
            "floor": null,
            "house": "748",
            "state": "ON",
            "street": "Bathurst St",
            "country": "CAN",
            "zipcode": "M5S 2R6",
            "intersection": null,
            "neighborhood_id": 43819,
            "formatted_address": "748 Bathurst St, Toronto, ON M5S 2R6, CAN"
        },
        "neighborhood_url": "/apartments/toronto-on/south-annex",
        "waitlist_enabled": false,
        "last_refreshed_on": null,
        "short_description": null,
        "building_amenities": [
            3,
            11,
            9
        ],
        "architectural_style": null,
        "supplemental_content": {
            "version": "v1.0",
            "keywords": null,
            "content_id": 65223975,
            "created_on": 1788408951,
            "content_url": "65223975",
            "description": null,
            "modified_on": 1792905110,
            "content_type": "listing",
            "last_generated": 0,
            "reviews_summary": null,
            "description_title": null,
            "property_overview": "Situated in a central Toronto location, 748 Bathurst St offers convenient access to transit, amenities, and the surrounding urban neighborhood. Its notable features and overall pros point to strong appeal for those seeking a well-connected city address with everyday convenience and a vibrant setting.",
            "supplemental_content_id": 1317511077
        },
        "building_amenity_tags": [
            "Air Conditioning",
            "On-Site Management",
            "Fitness Center"
        ],
        "income_restrictions_json": null,
        "min_price_lease_duration": null
    },
    "meta": {
        "duration_ms": 640,
        "upstream_calls": 1,
        "endpoint_family": "listing"
    },
    "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)
