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>",
  "ref": "<string>",
  "raison_social": "<string>",
  "forme_juridique": "<string>",
  "multi_activite": "<string>",
  "autres_denominations": "<string>",
  "nombre_etablissements": 123,
  "listing_type": "<string>",
  "is_verified": true,
  "latitude": 123,
  "longitude": 123,
  "opening_hours": "<any>",
  "images": "<string>",
  "external_links": "<string>",
  "payment_methods": "<string>",
  "prestations": "<string>",
  "products": "<string>",
  "brands": "<string>",
  "accepts_quote_requests": true,
  "reviews": "<any>"
}

GET

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>",
  "ref": "<string>",
  "raison_social": "<string>",
  "forme_juridique": "<string>",
  "multi_activite": "<string>",
  "autres_denominations": "<string>",
  "nombre_etablissements": 123,
  "listing_type": "<string>",
  "is_verified": true,
  "latitude": 123,
  "longitude": 123,
  "opening_hours": "<any>",
  "images": "<string>",
  "external_links": "<string>",
  "payment_methods": "<string>",
  "prestations": "<string>",
  "products": "<string>",
  "brands": "<string>",
  "accepts_quote_requests": true,
  "reviews": "<any>"
}

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/

string

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

additional_phone

string

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

ref

string

Input search URL the listing was discovered from

Legal business name as registered (raison sociale)

forme_juridique

string

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

multi_activite

string

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

autres_denominations

string

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

nombre_etablissements

integer

Total number of establishments registered under the same SIREN

listing_type

string

Listing tier on Pages Jaunes. Example: PROFESSIONNEL

is_verified

boolean

Whether the listing is verified on Pages Jaunes

latitude

float

Latitude of the business location

longitude

float

Longitude of the business location

opening_hours

json

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

images

string

Comma-separated list of all business image URLs

external_links

string

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

payment_methods

string

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

prestations

string

Comma-separated list of services offered by the business

products

string

Comma-separated list of products sold by the business

brands

string

Comma-separated list of brands carried by the business

accepts_quote_requests

boolean

Whether the business accepts quote requests via Pages Jaunes

reviews

json

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

Update Settings Add Tasks

​Headers

​Query Parameters

​Result Fields

Headers

Query Parameters

Result Fields