PagesJaunes Scraper — Extract French Business Directory Data

Extract business listings, contact details, ratings, and company information from PagesJaunes.fr — France's largest professional directory with 4+ million businesses.

What does PagesJaunes Scraper do?

PagesJaunes Scraper extracts structured business data from pagesjaunes.fr, the French Yellow Pages. Search by activity/profession and location to get complete business listings including contact info, ratings, opening hours, and SIRET numbers.

Two scraping modes

Listing mode (fast) — Extracts data from search result pages:

• Business name, category, full address, phone number
• Rating and review count
• Premium/organic status
• ~1,000 results in 2 minutes

Detail mode (comprehensive) — Visits each business page for extra data:

• Full business description
• Opening hours for each day
• SIRET company registration number
• Website and email (when available)
• ~1,000 results in 30 minutes

Use cases

• Lead generation — Build targeted B2B prospect lists by profession and city
• Market research — Analyze business density, pricing, and competition in any French market
• Competitive analysis — Monitor competitors' ratings, reviews, and service offerings
• Sales prospecting — Enrich your CRM with verified French business contact data
• Local SEO — Audit business presence across different French cities and regions
• Data enrichment — Add SIRET numbers, opening hours, and descriptions to existing databases

Input example

{
    "keyword": "plombier",
    "location": "Annecy",
    "maxItems": 50,
    "scrapeDetails": true,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "FR"
    }
}

Input parameters

Parameter	Type	Required	Description
keyword	String	Yes	Business activity or profession (e.g., "plombier", "restaurant", "avocat")
location	String	Yes	City, postal code, or region (e.g., "Paris", "Lyon 69000")
maxItems	Integer	No	Maximum results to return. Default: 100. Set to 0 for all results.
scrapeDetails	Boolean	No	Visit each business page for description, hours, SIRET. Default: false.
maxRequestRetries	Integer	No	Retry attempts per request. Default: 3.
proxyConfiguration	Object	No	Proxy settings. French residential proxies recommended.

Output example

[
    {
        "businessName": "AG Plomberie et Chauffage",
        "url": "https://www.pagesjaunes.fr/pros/56171189",
        "category": "plombiers",
        "address": "21 impasse Oilly 74150 Marcellaz Albanais",
        "postalCode": "74150",
        "city": "Marcellaz Albanais",
        "phone": "06 63 57 70 59",
        "rating": 4.5,
        "reviewCount": 37,
        "isPremium": true,
        "businessDescription": "En 2014, il cree l'entreprise AG Plomberie...",
        "openingHours": "Lundi 08h30 - 18h15 | Mardi 08h15 - 18h15 | ...",
        "siret": "83434245300018",
        "scrapedAt": "2026-03-31T01:58:17.268672+00:00"
    },
    {
        "businessName": "Agir Plomberie",
        "url": "https://www.pagesjaunes.fr/pros/08743323",
        "category": "plombiers",
        "address": "4 rue Burgonde 74000 Annecy",
        "postalCode": "74000",
        "city": "Annecy",
        "phone": "06 15 73 53 62",
        "rating": 4.8,
        "reviewCount": 18,
        "isPremium": true,
        "businessDescription": "Agir Plomberie est une entreprise experimentee...",
        "openingHours": "Lundi 08h30 - 18h15 | Mardi 08h15 - 18h15 | ...",
        "siret": "49036372800018",
        "scrapedAt": "2026-03-31T01:58:04.129994+00:00"
    }
]

Output fields

Field	Type	Mode	Description
businessName	String	Both	Company or professional name
url	String	Both	PagesJaunes listing URL
category	String	Both	Business category (e.g., "plombiers")
address	String	Both	Full street address
postalCode	String	Both	French postal code
city	String	Both	City name
phone	String	Both	Phone number (formatted: 06 12 34 56 78)
rating	Number	Both	Average rating (1-5)
reviewCount	Integer	Both	Number of reviews
isPremium	Boolean	Both	Whether the listing is a paid advertisement
businessDescription	String	Detail	Full business description
openingHours	String	Detail	Opening hours for each day
siret	String	Detail	French company registration number
website	String	Detail	Business website URL
email	String	Detail	Contact email (when public)
scrapedAt	String	Both	ISO 8601 timestamp of extraction

Proxy configuration

PagesJaunes.fr requires French residential proxies for reliable extraction. Configure:

"proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "FR"
}

Datacenter proxies will result in 403 errors.

Limitations

• Professional listings only — Does not extract personal data (Pages Blanches)
• Hidden phone numbers — Some businesses mask their number behind a click; these are extracted when available in HTML
• Rate limiting — Delays between requests are enforced to respect the website; large extractions take longer
• Search radius — PagesJaunes may expand search radius when few results match the exact location
• French territory — Only works for businesses listed on pagesjaunes.fr (France, DOM-TOM)

FAQ

Q: Why do I get 403 errors? A: You need French residential proxies. Datacenter proxies are blocked. See proxy configuration above.

Q: Can I scrape all businesses in a city? A: Yes! Set maxItems to 0 to extract all available results. PagesJaunes typically shows up to 1,000-2,000 results per search.

Q: How fresh is the data? A: Data is extracted in real-time from pagesjaunes.fr. Business information is as current as the PagesJaunes database.

Q: Is the SIRET number always available? A: SIRET is available on most business pages in detail mode. Some businesses don't have it listed.

Changelog

• v0.1 — Initial release: listing + detail mode, pagination, proxy support