# PagesJaunes Search

## Overview

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

## Description

Search PagesJaunes for French local businesses by category and location, returning paginated results with contact details and ratings.

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

## Example Response

### Search for dentists in Toulouse

```json
{
  "results": [
    {
      "id": "56824689",
      "url": "https://www.pagesjaunes.fr/pros/56824689",
      "name": "Agustin Mayo",
      "tags": [
        "détartrage dentaire",
        "radiologie dentaire",
        "sur rendez-vous",
        "blanchiment"
      ],
      "address": "13 place Lafourcade 31400 Toulouse",
      "activity": "Chirurgien-dentiste",
      "image_url": "https://www.pagesjaunes.fr/media/newdam/preset-thumbnail-lr-health/5c/33/7e/00/00/f0/04/18/50/c1/5d415c337e0000f0041850c1/5d415c337e0000f0041850c2.jpg"
    },
    {
      "id": "62118760",
      "url": "https://www.pagesjaunes.fr/pros/62118760",
      "name": "Association Centre de Santé Toulouse Bayard",
      "tags": [
        "soin bucco-dentaire",
        "chirurgie dentaire",
        "blanchiment dentaire"
      ],
      "address": "43 rue Bayard 31000 Toulouse",
      "activity": "Centre dentaire"
    },
    {
      "id": "54123915",
      "url": "https://www.pagesjaunes.fr/pros/54123915",
      "name": "Fabrice Chapsal",
      "tags": [
        "Conventionné"
      ],
      "rating": 5,
      "address": "Centre Medical Croix De Pierre 4 boulevard Deodat de Severac 31300 Toulouse",
      "activity": "Chirurgien-dentiste",
      "reviews_count": 1
    }
  ],
  "pagination": {
    "next": 2,
    "current": 1,
    "other_pages": [
      2,
      3,
      4,
      5,
      6,
      7,
      8,
      9,
      10
    ],
    "total_pages": 37,
    "has_next_page": true
  }
}
```

## Documentation

## Overview
The PagesJaunes Search endpoint returns paginated French business listings from a PagesJaunes search URL, including contact details and ratings.

## Quickstart
```
GET https://api.piloterr.com/v2/pagesjaunes/search?query=https://www.pagesjaunes.fr/annuaire/chercherlespros?quoiqui=Dentiste%26ou=Toulouse+%2831000%29%26univers=pagesjaunes%26idOu=
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Valid PagesJaunes search URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results[].id` | string | Business ID |
| `results[].name` | string | Business name |
| `results[].activity` | string | Business category |
| `results[].address` | string | Address |
| `results[].rating` | number | Rating |

## Notes
- URL-encode `&` as `%26`.
- Use the `id` with the Page Info endpoint for full details.

## Main use cases
- Build local business discovery tools for French markets
- Generate B2B lead lists of French businesses by industry and city
- Monitor competitor landscapes in French cities
- Power French market research and analysis