Skip to content
Examples

Get Results

Retrieve scraped data from Pages Jaunes Companies Search Export

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Pages Jaunes Companies Search Export runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

item_idstring

Unique identifier for the business on PagesJaunes. Example: 50819340

titlestring

Business name as listed on PagesJaunes. Example: Story Vannes

urlstring

Direct URL to the business listing on PagesJaunes. Example: https://www.pagesjaunes.fr/pros/50819340#zoneHoraires

scorefloat

Average customer rating of the business on PagesJaunes. Example: 4.7

ratingsinteger

Total number of customer reviews on PagesJaunes. Example: 282

full_addressstring

Full formatted address of the business. Example: Zac De Luscanen 9 avenue Louis de Cadoudal 56880 Ploeren

street_addressstring

Street address without postal code and city. Example: Zac De Luscanen 9 avenue Louis de Cadoudal

zip_codestring

Postal code of the business location. Example: 56880

citystring

City where the business is located. Example: Ploeren

descriptiontext

Business description or tagline as shown on PagesJaunes. Example: Avez-vous besoin d'un magasin pour meubler et décorer votre maison ? Notre magasin vous propose les dernières tendances de l'ameublement et de la décoration, des exclusivités innovantes et colorées. Vous trouverez un large choix de meubles pour salon, mobilier design, literie, relaxation et chambre. Nous fabriquons et installons également des dressings.

tagsstring

Tags or keywords associated with the business on PagesJaunes. Example: vitrine, livraison sur toute la France, meuble de salon, livraison à domicile, dressing, montage à domicile, canapé cuir, literie

image_urlstring

URL of the business's main image on PagesJaunes. Example: https://www.pagesjaunes.fr/media/newdam/preset-thumbnail-logo-desktop/be/9e/30/00/00/90/d7/46/a6/d3/6994be9e30000090d746a6d3/6994be9e30000090d746a6d4.jpg

phonestring

Primary phone number of the business. Example: 02 97 63 87 80

siretstring

French company SIRET number (14-digit unique identifier). Example: 48489335900014

naf_codestring

French NAF/APE activity code identifying the business sector. Example: 4759A

shop_sizestring

Size category of the business location. Example: 3 à 5 salariés

shop_typestring

Type or format of the business (e.g. chain store, independent). Example: Siège

sirenint

French company SIREN number (9-digit identifier). Example: 484893359

activitystring

Main activity or trade of the business. Example: magasins de meubles

company_hqstring

Location of the company headquarters

company_creation_datedatetime

Date the company was founded. Example: 2005-10-31T23:00:00+00:00

company_sizestring

Company size by number of employees (e.g. 1–10, 50–200). Example: 3 à 5 salariés

websitestring

Business website URL. Example: https://www.story.fr/magasins/meuble-vannes-story/

facebookstring

Facebook page URL of the business. Example: https://www.facebook.com/story.francereseau

instagramstring

Instagram profile URL of the business. Example: https://www.instagram.com/storyvannes/

emailstring

Email address of the business. Example: story.vannes@story.fr

additional_phonestring

Secondary or alternative phone number of the business. Example: 0297638780

refstring

Input search URL the listing was discovered from

raison_socialstring

Legal business name as registered (raison sociale)

forme_juridiquestring

French legal form code of the company (e.g. SAS, SARL, EI)

multi_activitestring

Comma-separated list of all activities the business is registered for

autres_denominationsstring

Comma-separated list of alternative trade names registered for the business

nombre_etablissementsinteger

Total number of establishments registered under the same SIREN

listing_typestring

Listing tier on Pages Jaunes. Example: PROFESSIONNEL

is_verifiedboolean

Whether the listing is verified on Pages Jaunes

latitudefloat

Latitude of the business location

longitudefloat

Longitude of the business location

opening_hoursjson

JSON-encoded weekly opening hours, keyed by day in French. Example: {"Lundi": "09:00-18:00", "Mardi": "09:00-18:00"}

imagesstring

Comma-separated list of all business image URLs

external_linksstring

Comma-separated list of all external website and social URLs of the business

payment_methodsstring

Comma-separated list of accepted payment methods. Example: Carte bancaire, Chèque, Espèces

prestationsstring

Comma-separated list of services offered by the business

productsstring

Comma-separated list of products sold by the business

brandsstring

Comma-separated list of brands carried by the business

accepts_quote_requestsboolean

Whether the business accepts quote requests via Pages Jaunes

reviewsjson

JSON-encoded list of the most recent customer reviews (up to 20)

Response

200
{
  "total_results": 1,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "result_from": 1,
  "result_to": 1,
  "data": [
    {
      "id": 21375,
      "object": "result",
      "squid": "b028468237e0aa1f0ef441023b91a729",
      "run": "de3f1917f27c05d6f209b5d86447e4c6",
      "item_id": "50819340",
      "title": "Story Vannes",
      "url": "https://www.pagesjaunes.fr/pros/50819340#zoneHoraires",
      "score": 4.7,
      "ratings": 282,
      "full_address": "Zac De Luscanen 9 avenue Louis de Cadoudal 56880 Ploeren",
      "street_address": "Zac De Luscanen 9 avenue Louis de Cadoudal",
      "zip_code": "56880",
      "city": "Ploeren",
      "description": "Avez-vous besoin d'un magasin pour meubler et décorer votre maison ? Notre magasin vous propose les dernières tendances de l'ameublement et de la décoration, des exclusivités innovantes et colorées. Vous trouverez un large choix de meubles pour salon, mobilier design, literie, relaxation et chambre. Nous fabriquons et installons également des dressings.",
      "tags": "vitrine, livraison sur toute la France, meuble de salon, livraison à domicile, dressing, montage à domicile, canapé cuir, literie",
      "image_url": "https://www.pagesjaunes.fr/media/newdam/preset-thumbnail-logo-desktop/be/9e/30/00/00/90/d7/46/a6/d3/6994be9e30000090d746a6d3/6994be9e30000090d746a6d4.jpg",
      "phone": "02 97 63 87 80",
      "siret": "48489335900014",
      "naf_code": "4759A",
      "shop_size": "3 à 5 salariés",
      "shop_type": "Siège",
      "siren": 484893359,
      "activity": "magasins de meubles",
      "company_hq": null,
      "company_creation_date": "2005-10-31T23:00:00+00:00",
      "company_size": "3 à 5 salariés",
      "website": "https://www.story.fr/magasins/meuble-vannes-story/",
      "facebook": "https://www.facebook.com/story.francereseau",
      "instagram": "https://www.instagram.com/storyvannes/",
      "email": "story.vannes@story.fr",
      "additional_phone": "0297638780",
      "ref": "https://www.pagesjaunes.fr/annuaire/paris-75/boulanger",
      "raison_social": "Atie Bat",
      "forme_juridique": "5710",
      "multi_activite": "Plombiers, Entreprises d'électricité générale, Dépannage plomberie, Vitrerie",
      "autres_denominations": "DENOMINATION ALTERNATIVE 1, DENOMINATION ALTERNATIVE 2",
      "nombre_etablissements": 0,
      "listing_type": "PROFESSIONNEL",
      "is_verified": true,
      "latitude": 48.856898,
      "longitude": 2.350843,
      "opening_hours": "{\"Lundi\": [\"06h00 - 23h00\"], \"Mardi\": [\"06h00 - 23h00\"]}",
      "images": "https://www.pagesjaunes.fr/media/img1.jpg, https://www.pagesjaunes.fr/media/img2.jpg",
      "external_links": "https://www.atie-bat.fr/contact",
      "payment_methods": "CB, Espèces, Chèque, Virement",
      "prestations": "réparation d'émail de sanitaire, réparation de chauffe-eau",
      "products": "wc, robinetterie, cabine de douche",
      "brands": "GROHE, Ideal Standard, Vaillant",
      "accepts_quote_requests": false,
      "reviews": "[{\"author\": \"Jean D.\", \"rating\": 5, \"date\": \"2025-04-10\", \"text\": \"Excellent service.\"}]",
      "functions": null,
      "native_id": 21375
    }
  ],
  "next": null,
  "previous": null
}