# Zoopla Property

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/zoopla/property` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/zoopla-property |

## Description

Extract full property details from a Zoopla listing URL, including price, specs, photo gallery, EPC rating, coordinates, and agent data.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/zoopla/property' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup Fontenoy Road, London SW12 rental

```json
{
  "id": 73119609,
  "url": "https://www.zoopla.co.uk/to-rent/details/73119609/",
  "agent": {
    "url": "https://www.zoopla.co.uk/find-agents/branch/hamptons-balham-lettings-london-54599/",
    "logo": "https://st.zoocdn.com/zoopla_static_agent_logo_(707660).png",
    "name": "Hamptons - Balham Lettings"
  },
  "price": {
    "amount": 6500,
    "currency": "£"
  },
  "title": "Fontenoy Road, London SW12, 5 bed flat to rent, £6,500 pcm - Zoopla",
  "address": "Fontenoy Road, London SW12",
  "gallery": [
    "https://lid.zoocdn.com/u/1024/768/41b277e206b85594ff9640344cb1d4df52a22048.jpg",
    "https://lid.zoocdn.com/u/1024/768/fa0ef0ead995190d7f854c950ac358fb0272fbd9.jpg",
    "https://lid.zoocdn.com/u/1024/768/417db7998c57d84308c6dcfbccebb66011cd5b93.jpg",
    "https://lid.zoocdn.com/u/1024/768/1a9cc9ab3fed00eede77a3901de105b50446e161.jpg",
    "https://lid.zoocdn.com/u/1024/768/8ca19c24c10740ce508e03e072686e14066629f9.jpg",
    "https://lid.zoocdn.com/u/1024/768/8d0cdcba31a54e110395faaa10140bd8184ec7a8.jpg",
    "https://lid.zoocdn.com/u/1024/768/4a09b5ac1f71dc6b339b4be7ff9f655bdb2226ca.jpg",
    "https://lid.zoocdn.com/u/1024/768/bc01fa503a73fa1e007273f8b03a8076dfab45fa.jpg",
    "https://lid.zoocdn.com/u/1024/768/c4a0f0ce884e53d6c698df789353d1fa4d037e8c.jpg",
    "https://lid.zoocdn.com/u/1024/768/36cea20cd192f588adc601d9ef1c6e5fda77c671.jpg",
    "https://lid.zoocdn.com/u/1024/768/d330244ae643e466375da663b684e1f6f1c4655f.jpg",
    "https://lid.zoocdn.com/u/1024/768/2b246e662f3c0992f86236e37cb485c7e86d975e.jpg",
    "https://lid.zoocdn.com/u/1024/768/7fe30a1d9e4278de778a5c117838aebfdc17e8e1.jpg",
    "https://lid.zoocdn.com/u/1024/768/0807ce99b23f81d385456e18e765f32f379db630.jpg",
    "https://lid.zoocdn.com/u/1024/768/e8df2420da3f54ba7fc4b9b83407c64102d9fa11.jpg",
    "https://lid.zoocdn.com/u/1024/768/83743465607df3e78bd41893459d95a616dd37b7.jpg"
  ],
  "epc_rating": "EPC Rating: D",
  "floor_area": "2,750 sq ft",
  "coordinates": {
    "latitude": -0.142507,
    "longitude": 51.438041,
    "google_mape_source": "https://maps.prod.zoopla.co.uk/styles/portal/static/-0.142507,51.438041,13/480x160@2x.webp?marker=-0.142507%2C51.438041%7Cmap-static-pin-purple-76.png%7Cscale%3A0.5&Expires=1780582851&Key-Pair-Id=K12772E47ES84B&Signature=nSNhcXjanmuhwLfG9-Xh2V0hCHkdpt91oJyafvbzlonR2QrQxoFMzwxEQVZFbQevSaMg2YrRqawY0ec28VArr~tYXXMl302hYtHS2fGa9-0bssugWjD4YRmOeUh0UEmeMJsQNP6zs7jEGM~fy2vh-WnBFI~l7HFh0bVlp679wzkVJu3KyJDDsdilV1mUstD1u8QAV7J1dNB4iHdVGMoUvZiiQrVqsD1x0llwYlM~~8lcLuRmb3bubJANrKfyqXx-cm0gCbjyRpAnMiCm9PgvwJhXIilKtwyjYVlug2FpAgA30qoWvfyXDk4A4cXpI8VSX~UkXqyDzZWVNH-TvXBqtQ__"
  },
  "property_info": [
    {
      "title": "Deposit",
      "value": "£7,500"
    },
    {
      "title": "Council tax band",
      "value": "G"
    },
    {
      "title": "Letting arrangements",
      "value": "Ask agent"
    }
  ],
  "property_tags": [
    "EPC Rating: D"
  ],
  "num_of_bedrooms": 5,
  "num_of_bathrooms": 3,
  "num_of_receptions": 3,
  "property_description": [
    "Family home",
    "Off-street parking",
    "5 double bedrooms",
    "Central Balham location",
    "Large garden",
    "3 Bathrooms",
    "Disabled features"
  ]
}
```

## Documentation

## Overview
Extract comprehensive property details from a Zoopla listing page. Returns pricing, title, address, photo gallery, floor area, EPC rating, coordinates, agent info, property tags, and room counts via browser rendering.

## Quickstart
```
GET https://api.piloterr.com/v2/zoopla/property?query=https://www.zoopla.co.uk/to-rent/details/73119609/
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full Zoopla property detail URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | integer \| null | Zoopla listing ID |
| `url` | string | Canonical listing URL |
| `title` | string \| null | Page title |
| `address` | string \| null | Property address |
| `price.amount` | integer \| null | Listing price |
| `price.currency` | string \| null | Currency symbol |
| `agent.name` | string \| null | Estate agent name |
| `agent.url` | string \| null | Agent branch URL |
| `agent.logo` | string \| null | Agent logo URL |
| `gallery` | array | Property photo URLs; may be empty |
| `coordinates.latitude` | number \| null | Latitude |
| `coordinates.longitude` | number \| null | Longitude |
| `coordinates.google_mape_source` | string \| null | Static map image URL |
| `floor_area` | string \| null | Floor area label |
| `epc_rating` | string \| null | EPC rating label |
| `num_of_bedrooms` | integer \| null | Number of bedrooms |
| `num_of_bathrooms` | integer \| null | Number of bathrooms |
| `num_of_receptions` | integer \| null | Number of reception rooms |
| `property_info` | array | Key-value property details (deposit, council tax, etc.); may be empty |
| `property_tags` | array | Property feature tags; may be empty |
| `property_description` | array | Highlight bullet points; may be empty |

## Notes
- Only full Zoopla `/details/` URLs are accepted as `query`.
- Works for for-sale, to-rent, and new-homes listing pages.
- `property_info`, `property_tags`, and `property_description` vary by listing type and may be empty.
- `agent`, `gallery`, coordinates, and room counts may be partial or `null` on some listings.

## Main use cases
- Enrich CRM records with full property specs and agent data
- Extract photo galleries and coordinates for map-based tools
- Analyze EPC ratings, floor area, and room counts from live listings
- Power comp tools with price and location data from Zoopla