# Idealo Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/idealo/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/idealo-product |

## Description

Extract detailed real estate data from Idealista's listings with Piloterr's Idealo Product API for precise property insights.

## 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/idealo/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "id": "104455801",
  "agent": {
    "name": "Best Home",
    "email": "contact@besthome.pt",
    "contactNumber": "+351 284 345 123"
  },
  "price": "2.490.000 €",
  "title": "Maison ou villa de 566 m², Mercês, Lisboa",
  "images": [
    "https://media.idealista.com/1.jpg",
    "https://media.idealista.com/2.jpg",
    "https://media.idealista.com/3.jpg"
  ],
  "address": "Mercês, Lisboa",
  "features": {
    "area": 566,
    "pool": "Yes",
    "garage": "Yes",
    "garden": "Yes",
    "bedrooms": 5,
    "bathrooms": 5,
    "condition": "Well maintained",
    "yearBuilt": "1995",
    "energyCertificate": "B"
  },
  "location": {
    "latitude": 38.716,
    "longitude": -9.146
  },
  "description": "This villa in Lisbon is a three-story property, with a total area of 566 m², featuring 5 bathrooms and 5 bedrooms. It includes a garage, terrace and garden, along with a pool providing scenic city views.",
  "propertyType": "Maison ou Villa",
  "miscellaneous": {
    "numberOfVisits": 45,
    "publicationDate": "2023-08-15"
  }
}
```

## Documentation

## Overview
Extract detailed real estate data from Idealista's listings with Piloterr's Idealo Product API for precise property insights.

## Quickstart
```
GET https://api.piloterr.com/v2/idealo/product?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Idealo Product data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Idealo without maintaining scrapers
- Power internal dashboards and workflow automations with live Idealo data