# PagesJaunes Scraper (French Businesses) (`reventadata/pagesjaunes-scraper`) Actor

Extract French business listings from PagesJaunes.fr by city and category: name, activity, address, rating, review count and website. Optional phone, SIRET, SIREN, NAF code, legal form, coordinates and opening hours per business. Public pages, no login.

- **URL**: https://apify.com/reventadata/pagesjaunes-scraper.md
- **Developed by:** [reventadata](https://apify.com/reventadata) (community)
- **Categories:** Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

> **Unofficial.** This Actor is not affiliated with, authorised by, endorsed by, or in any
> way officially connected to PagesJaunes or Solocal. "PagesJaunes" is a trademark of its
> respective owner and is used here only to describe what this tool reads. It reads the same
> public pages a browser does.

PagesJaunes Scraper reads business listings from [PagesJaunes.fr](https://www.pagesjaunes.fr), the
French business directory: name, activity, address, rating and review count, the website a business
lists, and optionally its phone number, SIRET, SIREN, NAF code, legal form, coordinates and opening hours.

### What data can you extract from PagesJaunes?

- **From the category pages:** name, main activity, service tags, description, address (street,
  postcode, city), rating, review count and website.
- **With "Fetch phone and company data" on:** phone number as published, SIRET, SIREN, NAF code,
  establishment and company headcount bands, establishment type, legal form, company creation date,
  latitude, longitude, opening hours and the main image. This opens each business profile, one extra
  request per business.

### How to scrape PagesJaunes

1. Give the categories you want. Either list `searches` entries, each with the site's own slugs:
   `location` (a city slug ending in the department number, for example `lyon-69`, or
   `departement/rhone-69`) and `rubrique` (for example `plombiers`); or paste full category URLs
   into `startUrls`. Copy the slugs from any category URL on pagesjaunes.fr:
   `https://www.pagesjaunes.fr/annuaire/<location>/<rubrique>`.
2. Set `maxItems` and `maxPages` (20 businesses per page).
3. Turn on `fetchDetails` if you need phone numbers or company data.
4. Run it and download the dataset as JSON, CSV, Excel or NDJSON.

#### Input

| Field | Type | Description |
|---|---|---|
| `searches` | array | Objects `{"location": "lyon-69", "rubrique": "plombiers"}`. |
| `startUrls` | array | Full category URLs. Search URLs and URLs with a query string are rejected. |
| `maxItems` | integer | Maximum businesses across all searches. |
| `maxPages` | integer | Pages per search, at most 500 (the site's own ceiling). |
| `fetchDetails` | boolean | Add phone and company data from each profile. Off by default. |
| `proxyConfiguration` | object | Optional. Apify Proxy settings, off by default. |

#### Sample input

```json
{
    "searches": [{"location": "lyon-69", "rubrique": "plombiers"}],
    "maxItems": 20,
    "maxPages": 1,
    "fetchDetails": true
}
```

#### Output

One row per business. Fields that need a profile fetch are `null` when `fetchDetails` is off.
`detailStatus` says what happened: `not_requested`, `ok`, `not_found`, `failed` or `skipped`.

#### Sample output

Generated from a real local run (2026-11-07), `fetchDetails` on, description shortened here:

```json
{
    "id": "55824372",
    "url": "https://www.pagesjaunes.fr/pros/55824372",
    "name": "E2P Plomberie",
    "activity": "plombiers",
    "moreActivitiesCount": 0,
    "services": ["installation de sanitaire", "rénovation de salle de bain", "rénovation de sanitaire", "installateur de cabine de douche"],
    "rating": 5.0,
    "reviewCount": 57,
    "address": "rue Victor Hugo 69002 Lyon",
    "street": "rue Victor Hugo",
    "postalCode": "69002",
    "city": "Lyon",
    "website": null,
    "phone": "04 87 78 93 32",
    "siret": "79904349200039",
    "siren": "799043492",
    "nafCode": "4322A",
    "establishmentType": "Siège",
    "legalForm": "Société à responsabilité limitée (sans autre indication)",
    "companyCreatedOn": "4 décembre 2013",
    "latitude": 45.754646,
    "longitude": 4.830164,
    "openingHours": ["Monday 07:00-19:00", "Tuesday 07:00-19:00", "Wednesday 07:00-19:00", "Thursday 07:00-19:00", "Friday 07:00-19:00"],
    "detailStatus": "ok",
    "searchUrl": "https://www.pagesjaunes.fr/annuaire/lyon-69/plombiers"
}
```

### Notes and limits

- **Slugs, not free text.** You give the site's city and category slugs, not a keyword. The site's
  own keyword search is not used.
- **At most 500 pages (10,000 businesses) per search.** For a larger niche, split by city or department.
- **Sponsored cards repeat across pages;** each business id is returned once.
- **A search that matches nothing ends with a status message and no rows.** A run where the site
  could not be read ends as failed with the reason.
- **A business with no published phone** has `phone` null; the row is still saved.
- Rows are businesses: name, address, phone and identifiers they publish themselves. Reviews and
  reviewer names are not collected.

### How much does it cost?

Pay-per-event: **$0.001 per business** saved to the dataset (**$1.00 per 1,000 businesses**), plus **$0.00005** charged once when the run starts. No subscription. `fetchDetails` adds no charge. Each business is saved once, so repeats are not charged.

### FAQ

**How do I find a location and category slug?** Browse to a category on pagesjaunes.fr and copy the
two parts after `/annuaire/`, for example `lyon-69` and `plombiers` from
`https://www.pagesjaunes.fr/annuaire/lyon-69/plombiers`.

**Why are phone numbers empty?** The category pages carry no phone. Turn on `fetchDetails`.

### More marketplace scrapers

| Actor | What it scrapes |
|---|---|
| [Otodom Scraper](https://apify.com/reventadata/otodom-scraper) | Otodom, Poland: property listings |
| [Imovirtual Scraper](https://apify.com/reventadata/imovirtual-scraper) | Imovirtual, Portugal: property listings |
| [OLX Romania Scraper](https://apify.com/reventadata/olx-ro-scraper) | OLX Romania (olx.ro): any category |

# Actor input Schema

## `searches` (type: `array`):

List of objects with the site's own slugs: "location" is a city slug ending in the department number such as "lyon-69", or "departement/rhone-69" for a whole department; "rubrique" is the category slug such as "plombiers". Copy both from a category URL on pagesjaunes.fr (https://www.pagesjaunes.fr/annuaire/<location>/<rubrique>). Free-text keywords are not supported. Give searches, startUrls, or both.

## `startUrls` (type: `array`):

Optional. Full pagesjaunes.fr category URLs of the form https://www.pagesjaunes.fr/annuaire/<city>-<dept>/<rubrique> or https://www.pagesjaunes.fr/annuaire/departement/<name>-<dept>/<rubrique>. Search URLs (with ?quoiqui=) and URLs with a query string are rejected.

## `maxItems` (type: `integer`):

Maximum number of businesses to save across all searches. Each page holds 20 businesses.

## `maxPages` (type: `integer`):

Pages to read per search (20 businesses each). The site serves at most 500 pages (10,000 businesses) per search; split larger searches by city or department.

## `fetchDetails` (type: `boolean`):

Opens each business profile (one extra request per business, so the run is slower) to add the phone number, SIRET, SIREN, NAF code, legal form, company creation date, headcount bands, coordinates and opening hours. Off: list data only, which has no phone number.

## `proxyConfiguration` (type: `object`):

Optional. Apify Proxy settings; leave off unless the site refuses your runs.

## Actor input object example

```json
{
  "searches": [
    {
      "location": "lyon-69",
      "rubrique": "plombiers"
    }
  ],
  "startUrls": [],
  "maxItems": 20,
  "maxPages": 1,
  "fetchDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

Items scraped from the target website.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searches": [
        {
            "location": "lyon-69",
            "rubrique": "plombiers"
        }
    ],
    "startUrls": [],
    "maxItems": 20,
    "maxPages": 1,
    "fetchDetails": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("reventadata/pagesjaunes-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searches": [{
            "location": "lyon-69",
            "rubrique": "plombiers",
        }],
    "startUrls": [],
    "maxItems": 20,
    "maxPages": 1,
    "fetchDetails": False,
}

# Run the Actor and wait for it to finish
run = client.actor("reventadata/pagesjaunes-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searches": [
    {
      "location": "lyon-69",
      "rubrique": "plombiers"
    }
  ],
  "startUrls": [],
  "maxItems": 20,
  "maxPages": 1,
  "fetchDetails": false
}' |
apify call reventadata/pagesjaunes-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,reventadata/pagesjaunes-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/3MSaNTFwO0kuYoWey/builds/pxmI35jch2gy1bcrn/openapi.json
