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