# PagesJaunes — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for business listings across France on PagesJaunes.fr and access customer reviews and detailed location information. Find businesses by keyword and location, and retrieve comprehensive details including addresses, ratings, and reviews.

**Category:** Business Directories | **Website:** [pagesjaunes.fr/](https://pagesjaunes.fr/) | **Docs:** [parse.bot/marketplace/1fe4bc21-3467-40ce-a5b1-c5b7ef52d820/pagesjaunes-fr-api](https://parse.bot/marketplace/1fe4bc21-3467-40ce-a5b1-c5b7ef52d820/pagesjaunes-fr-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-pagesjaunes-fr-api-1fe4bc21/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_store_details

Get detailed information for a specific store including full address, geographic coordinates (latitude/longitude from structured data), and all customer reviews with ratings and dates. The store_id comes from the search_stores endpoint results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_id` | string | Yes | The business listing ID from search_stores results (e.g. '05416214'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pagesjaunes-fr-api-1fe4bc21/get_store_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store_id":"<string>"}'
```

### search_stores

Search for businesses by keyword and location (city, department, or region). Returns a paginated list of results with basic information including name, address, rating, and review count. Each page returns up to 20 results. The total_count_text field provides the human-readable count of all matching results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | City, department number, or region name to search in. |
| `page` | integer | No | Page number for pagination (20 results per page). |
| `query` | string | No | Search query term. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pagesjaunes-fr-api-1fe4bc21/search_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","query":"<string>"}'
```