# Meilleurs Agents Product

## Overview

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

## Description

Extract detailed property listings from Meilleurs Agents to enhance real estate insights and market strategies.

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

## Example Response

### Example

```json
{
  "listing": {
    "id": "1974748058",
    "price": "835,000 €",
    "rooms": 3,
    "title": "Appartement 3 pièces 83 m²",
    "agents": [
      {
        "name": "Jean Dupont",
        "phone": "+33 6 23 45 67 89",
        "license": "123456789"
      }
    ],
    "photos": [
      "https://photos.meilleursagents.com/photo1.jpg",
      "https://photos.meilleursagents.com/photo2.jpg",
      "https://photos.meilleursagents.com/photo3.jpg"
    ],
    "address": "Rue de Balzac, 75008 Paris",
    "contact": {
      "name": "Agence ImmoParis",
      "email": "contact@immoparis.fr",
      "phone": "+33 1 23 45 67 89"
    },
    "details": {
      "floor": 3,
      "heating": "Individuel électrique",
      "condition": "Excellent état"
    },
    "surface": "83 m²",
    "bedrooms": 2,
    "description": "Très bel appartement lumineux, récemment rénové...",
    "propertyType": "Appartement"
  }
}
```

## Documentation

## Overview
Extract detailed property listings from Meilleurs Agents to enhance real estate insights and market strategies.

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

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

## Main use cases
- Integrate Meilleurs Agents Product 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