GET/v1/results

Get Results

Retrieve scraped Pages Jaunes business listings with company details and registration numbers

Retrieve business listings scraped from Pages Jaunes search results. Each result contains comprehensive company information including contact details, addresses, official French business registration numbers (SIRET/SIREN), NAF activity codes, and social media profiles.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

Result Fields

id
integer
Unique identifier for this result record
Example: 2454
object
string
Object type, always "result"
Example: result
squid
string
Hash ID of the squid that produced this result
Example: 4a68464aef0a4067b161f64579278a58
run
string
Hash ID of the run during which this result was scraped
Example: e13f5d4f74af4f4f89c5a4fc535a031e
title
string
Business name or listing title
Example: Boulanger Opera
activity
string
Search filter/category used
Example: magasins d'electromenager +2
description
string
Business description text
Example: Bonjour et bienvenue dans votre magasin Boulanger...
full_address
string
Complete street address
Example: 30 boulevard Capucines 75009 Paris
city
string
City where the business is located
Example: Paris
zip_code
string
Postal code for the listing
Example: 75009
phone
string
Primary phone number
Example: 01 42 65 12 34
additional_phone
string
Secondary phone number if available
Example: ""
email
string
Contact email address (if collect_contacts enabled)
Example: contact@example.com
website
string
Business website URL
Example: https://www.boulanger.com/magasins/...
siret
string
14-digit French business identification number
Example: 34738457001969
siren
string
9-digit company registration number
Example: 347384570
naf_code
string
NAF activity classification code
Example: 4754Z
company_size
string
Company employee count category
Example: 5000 a 9999 salaries
company_creation_date
string
ISO date when company was founded
Example: 1988-03-24T00:00:00Z
company_hq
string
Address of company headquarters
Example: ""
shop_size
string
Establishment employee count category
Example: 50 a 99 salaries
shop_type
string
Establishment type
Example: Etablissement secondaire
facebook
stringnull
Facebook page URL if listed
Example: null
instagram
stringnull
Instagram profile URL if listed
Example: https://www.instagram.com/Boulangeropera/
image_url
string
URL of business logo or main image
Example: /media/newdam/preset-thumbnail-logo-desktop/...
tags
string
Comma-separated service tags
Example: livraison a domicile, retrait en magasin, ...
score
number
Average rating score
Example: 1
ratings
integer
Number of customer ratings
Example: 0
item_id
string
Internal listing identifier
Example: 0001562094139200
url
string
Direct URL to the listing on Pages Jaunes
Example: https://www.pagesjaunes.fr/pros/detail?code_etablissement=...
scraping_time
string
ISO timestamp when the listing was fetched
Example: 2025-07-28T08:58:20.896Z
functions
objectnull
Function execution metadata including filling_date
Example: {results_details: {filling_date: 07/28/2025, 10:58:20 +0200}}

Parameters

squidstring
Required
The squid hash ID to get results from
runstring
Optional
Filter results by specific run hash ID
pageinteger
Optional
Page number for pagination (default: 1)
page_sizeinteger
Optional
Number of results per page (default: 100, max: 1000)
Pro Tip

Pro Tip

Use SIRET numbers to verify business legitimacy through the French government's official SIRENE database (sirene.fr).
Note

Note

NAF codes follow the French statistical classification system. Code 4754Z, for example, represents retail sale of electrical household appliances.