# Imovirtual Ad

## Overview

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

## Description

Retrieve a full Imovirtual property listing by URL with price, area, typology, coordinates, amenities, and agent data as structured JSON.

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

## Example Response

### T2 apartment listing in Campo de Ourique, Lisboa

```json
{
  "id": "imv-PT47821036",
  "url": "https://www.imovirtual.com/annonce/t2-venda-lisboa-campo-de-ourique-imv-PT47821036.html",
  "area": {
    "net_m2": 73.8,
    "land_m2": null,
    "gross_m2": 84.2
  },
  "price": {
    "amount": 389000,
    "currency": "EUR",
    "price_per_m2": 5271,
    "condominium_fee": 120
  },
  "title": "Apartamento T2 em venda, Campo de Ourique, Lisboa",
  "images": [
    "https://photos.imovirtual.com/PT47821036/1/1024x768.jpg",
    "https://photos.imovirtual.com/PT47821036/2/1024x768.jpg",
    "https://photos.imovirtual.com/PT47821036/3/1024x768.jpg"
  ],
  "status": "active",
  "features": {
    "floor": 3,
    "parking": "garage",
    "bedrooms": 2,
    "elevator": true,
    "bathrooms": 2,
    "condition": "like_new",
    "total_floors": 6,
    "construction_year": 1972,
    "energy_certificate": "B"
  },
  "location": {
    "parish": "Campo de Ourique",
    "district": "Lisboa",
    "latitude": 38.7168,
    "longitude": -9.1602,
    "full_address": null,
    "municipality": "Lisboa"
  },
  "typology": "T2",
  "amenities": [
    "Varanda",
    "Garagem",
    "Arrecadação",
    "Elevador",
    "Portaria",
    "Ar condicionado"
  ],
  "operation": "buy",
  "publisher": {
    "name": "ERA Lisboa Campo de Ourique",
    "type": "agency",
    "phone": "+351 21 395 7200",
    "license": "AMI 6423"
  },
  "reference": "ERA-COQ-2894",
  "thumbnail": "https://photos.imovirtual.com/PT47821036/1/320x240.jpg",
  "updated_at": "2026-05-02T09:00:00.000Z",
  "description": "Excelente apartamento T2 localizado no coração de Campo de Ourique, um dos bairros mais procurados de Lisboa. O imóvel dispõe de sala ampla com acesso a varanda, cozinha equipada, dois quartos (um em suite), duas casas de banho completas e arrecadação. Edifício com elevador e portaria. Totalmente remodelado em 2022 com materiais de qualidade premium.",
  "published_at": "2026-04-30T10:15:00.000Z",
  "property_type": "apartment",
  "floor_plan_url": "https://photos.imovirtual.com/PT47821036/planta.jpg",
  "virtual_tour_url": null
}
```

## Documentation

## Overview

Imovirtual is Portugal's leading real estate portal, part of OLX Group. Each listing page holds price, area, typology, floor, energy certificate, amenities, coordinates, images, and agent AMI license. The platform applies Cloudflare Bot Management. Piloterr handles the bypass and returns the full listing as structured JSON.

## Quickstart

```
GET https://api.piloterr.com/v2/imovirtual/ad?url=https://www.imovirtual.com/annonce/t2-venda-lisboa-campo-de-ourique-imv-PT47821036.html
```

## Main use cases

- Extract complete property data to build a CRM enrichment pipeline for real estate agents
- Collect price, area, and coordinates to train a property price prediction model for Portugal
- Monitor specific listings for price changes or status updates to trigger buyer alerts
- Aggregate energy certificates and construction years for sustainability reports on Portuguese housing
- Pull floor plans and image URLs to build a content database for a Portuguese property search engine