# Imovirtual Search

## Overview

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

## Description

Search Imovirtual Portugal property listings by location and get price, typology, area, and agent data as structured JSON in real time.

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

## Example Response

### T2 apartments for sale in Lisboa

```json
{
  "page": 1,
  "results": [
    {
      "id": "imv-PT47821036",
      "url": "https://www.imovirtual.com/annonce/t2-venda-lisboa-campo-de-ourique-imv-PT47821036.html",
      "price": 389000,
      "title": "Apartamento T2 em venda, Campo de Ourique, Lisboa",
      "area_m2": 73.8,
      "location": {
        "parish": "Campo de Ourique",
        "district": "Lisboa",
        "municipality": "Lisboa"
      },
      "typology": "T2",
      "operation": "buy",
      "thumbnail": "https://photos.imovirtual.com/PT47821036/1/320x240.jpg",
      "price_per_m2": 5271,
      "published_at": "2026-04-30T10:15:00.000Z",
      "property_type": "apartment",
      "publisher_name": "ERA Lisboa Campo de Ourique"
    },
    {
      "id": "imv-PT47803941",
      "url": "https://www.imovirtual.com/annonce/t3-venda-lisboa-estrela-imv-PT47803941.html",
      "price": 595000,
      "title": "Apartamento T3 renovado em venda, Estrela, Lisboa",
      "area_m2": 102.4,
      "location": {
        "parish": "Estrela",
        "district": "Lisboa",
        "municipality": "Lisboa"
      },
      "typology": "T3",
      "operation": "buy",
      "thumbnail": "https://photos.imovirtual.com/PT47803941/1/320x240.jpg",
      "price_per_m2": 5813,
      "published_at": "2026-04-27T14:30:00.000Z",
      "property_type": "apartment",
      "publisher_name": "Remax Lisboa Estrela"
    }
  ],
  "total_results": 6218,
  "results_per_page": 25
}
```

## Documentation

## Overview

Imovirtual is Portugal's leading real estate portal, part of OLX Group. It covers all Portuguese districts with the local T-typology system (T0–T5+). The platform applies Cloudflare Bot Management. Piloterr handles the bypass and returns paginated listings as structured JSON.

Each result includes asking price, price per m², area, typology, location to parish level, publication date, and publisher name.

## Quickstart

```
GET https://api.piloterr.com/v2/imovirtual/search?location=Lisboa&operation=buy&property_type=apartment&typology=T2
```

## Main use cases

- Track price per m² trends across Lisbon parishes for a Portuguese property valuation model
- Monitor new T2 and T3 listings in specific municipalities to surface investment opportunities early
- Build a rental yield calculator pairing Imovirtual sale and rental prices by typology and location
- Produce quarterly reports on Portuguese real estate by aggregating listing counts and price distributions
- Feed a buyer recommendation engine matching budgets and typology preferences to live listings