PagesJaunes API

Search the French Yellow Pages and pull business contacts, hours and reviews as clean JSON.

The API.SH PagesJaunes API returns businesses from PagesJaunes.fr, the French Yellow Pages, as structured JSON. Search by activity or name and a place to get each business's name, activity, address, distance, rating and review count, Google rating, opening status and service tags. Open any business for its phone, website, coordinates, opening hours by day, services, products, payment methods, brands, photos and its newest reviews in full with a rating breakdown.

Get a free API key Try it in the playground

2 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

PagesJaunes business search

GET https://api.api.sh/pagesjaunes/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the PagesJaunes API

B2B lead lists in France

Search an activity in a city, page through the results and open each business for phone, website and address to build a prospect list.

/search /business

Local market mapping

Count businesses per activity and town with total, and compare ratings and review counts to size a local market.

/search

Review monitoring

Read each location's newest reviews, rating breakdown and review count, and page further back with reviews_offset.

/business

Listing accuracy checks

Compare opening hours, phone, website and address on PagesJaunes with your own data across many locations.

/business

Export to Excel or Sheets

Send search results and business details to Google Sheets or CSV for teams that work in spreadsheets.

/search /business

PagesJaunes data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

PagesJaunes API endpoints and prices

Every PagesJaunes endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

PagesJaunes business search

/pagesjaunes/v1/search

$1 · $2 PAYG

1 credit

More data1

PagesJaunes business detail

/pagesjaunes/v1/business

$1 · $2 PAYG

1 credit

Call the PagesJaunes API

PagesJaunes business search: GET https://api.api.sh/pagesjaunes/v1/search

curl "https://api.api.sh/pagesjaunes/v1/search?q=plombier&location=Paris" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/pagesjaunes/v1/search",
    params={"q": "plombier", "location": "Paris"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/pagesjaunes/v1/search");
url.searchParams.set("q", "plombier");
url.searchParams.set("location", "Paris");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/pagesjaunes/v1/search", "q", "plombier", "location", "Paris")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "PagesJaunes" and "PagesJaunes business search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for PagesJaunes data

Public data only: no PagesJaunes login, cookies or account needed
One key and one response shape for PagesJaunes and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official PagesJaunes API

PagesJaunes has an official developer portal, but its APIs are built for partners that run local search services and display PagesJaunes results, not for general data access. API.SH needs no partnership and returns public search results, business details and reviews as JSON.

Compared with no-code PagesJaunes scrapers on Apify, lobstr.io or PhantomBuster, API.SH is a plain API with one key, a fixed price per call and the same JSON format across sites.

PagesJaunes API questions

What PagesJaunes data can I get?+

Business search by activity or name and place with ratings, Google ratings, opening status and service tags (/pagesjaunes/v1/search), and one business with phone, website, coordinates, hours, services, products, payment methods, photos and full reviews (/pagesjaunes/v1/business).

How much does the PagesJaunes API cost?+

Every PagesJaunes endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /pagesjaunes/v1/business at 1 credit each.

Is there an official PagesJaunes API?+

Yes, for partners. developer.pagesjaunes.fr offers APIs to partners that run local search services. API.SH is an alternative when you are not a partner and want public listing data as JSON.

Do I need a PagesJaunes account or login?+

No. API.SH reads public PagesJaunes pages only. No endpoint uses a login, cookies or anyone's account.

Can I export PagesJaunes results to Excel?+

Yes. Every endpoint can return CSV as well as JSON, and the Google Sheets add-on, Zapier, Make and n8n send results straight into a spreadsheet.

Can I use it from Python?+

Yes. Use the Python SDK or any HTTP client: send your key and call /pagesjaunes/v1/search with q and location, then pass next_page back as page for the next 20 results.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /pagesjaunes/v1/search with q (for example plombier) and location (for example Lyon). Docs are at https://api.sh/docs, with JS and Python SDKs, Google Sheets, Zapier, Make, n8n and the MCP server at https://api.sh/mcp.