# Meilleurs Agents Search

## Overview

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

## Description

Extract detailed property data from Meilleurs Agents and transform your real estate strategy with our powerful API.

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

## Example Response

### Example

```json
{
  "query": "achat/castres-81100",
  "results": [
    {
      "price": "275 000 €",
      "title": "Maison 5 pièces 150 m²",
      "details": {
        "type": "Maison",
        "rooms": "5",
        "surface": "150 m²",
        "land_surface": "800 m²",
        "price_per_m2": "1 833 €/m²"
      },
      "location": "Castres, 81100",
      "description": "Maison de 5 pièces de 150 m² sur un terrain de 800 m² à Castres."
    },
    {
      "price": "145 000 €",
      "title": "Appartement 3 pièces 70 m²",
      "details": {
        "type": "Appartement",
        "rooms": "3",
        "balcony": "Oui",
        "surface": "70 m²",
        "price_per_m2": "2 071 €/m²"
      },
      "location": "Castres, 81100",
      "description": "Appartement de 3 pièces de 70 m² avec balcon à Castres."
    }
  ],
  "metadata": {
    "source": "Meilleurs Agents",
    "scrape_date": "2023-10-15"
  },
  "pagination": {
    "total_pages": 2,
    "current_page": 1,
    "total_results": 20
  }
}
```

## Documentation

## Overview
Extract detailed property data from Meilleurs Agents and transform your real estate strategy with our powerful API.

## Quickstart
```
GET https://api.piloterr.com/v2/meilleurs/agents-search?query=example
```

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

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