Skip to main content
GET
/
v1
/
results
Get Results
curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'
{
  "item_id": "<string>",
  "title": "<string>",
  "url": "<string>",
  "score": 123,
  "ratings": 123,
  "full_address": "<string>",
  "zip_code": "<string>",
  "city": "<string>",
  "description": "<string>",
  "tags": "<string>",
  "image_url": "<string>",
  "phone": "<string>",
  "siret": "<string>",
  "naf_code": "<string>",
  "shop_size": "<string>",
  "shop_type": "<string>",
  "siren": 123,
  "activity": "<string>",
  "company_hq": "<string>",
  "company_creation_date": {},
  "company_size": "<string>",
  "website": "<string>",
  "facebook": "<string>",
  "instagram": "<string>",
  "email": "<string>",
  "additional_phone": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

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

Headers

Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squid
string
required
Hash of the squid to get results from
run
string
Hash of a specific run (optional)
page
integer
Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:
item_id
string
Unique identifier for the business on PagesJaunes. Example: 50819340
title
string
Business name as listed on PagesJaunes. Example: Story Vannes
url
string
Direct URL to the business listing on PagesJaunes. Example: https://www.pagesjaunes.fr/pros/50819340#zoneHoraires
score
float
Average customer rating of the business on PagesJaunes. Example: 4.7
ratings
integer
Total number of customer reviews on PagesJaunes. Example: 282
full_address
string
Full formatted address of the business. Example: Zac De Luscanen 9 avenue Louis de Cadoudal 56880 Ploeren
zip_code
string
Postal code of the business location. Example: 56880
city
string
City where the business is located. Example: Ploeren
description
text
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.
tags
string
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_url
string
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
phone
string
Primary phone number of the business. Example: 02 97 63 87 80
siret
string
French company SIRET number (14-digit unique identifier). Example: 48489335900014
naf_code
string
French NAF/APE activity code identifying the business sector. Example: 4759A
shop_size
string
Size category of the business location. Example: 3 à 5 salariés
shop_type
string
Type or format of the business (e.g. chain store, independent). Example: Siège
siren
int
French company SIREN number (9-digit identifier). Example: 484893359
activity
string
Main activity or trade of the business. Example: magasins de meubles
company_hq
string
Location of the company headquarters
company_creation_date
datetime
Date the company was founded. Example: 2005-10-31T23:00:00+00:00
company_size
string
Company size by number of employees (e.g. 1–10, 50–200). Example: 3 à 5 salariés
website
string
Business website URL. Example: https://www.story.fr/magasins/meuble-vannes-story/
facebook
string
Facebook page URL of the business. Example: https://www.facebook.com/story.francereseau
instagram
string
Instagram profile URL of the business. Example: https://www.instagram.com/storyvannes/
email
string
Email address of the business. Example: story.vannes@story.fr
additional_phone
string
Secondary or alternative phone number of the business. Example: 0297638780