{ "openapi": "3.0.1", "info": { "title": "PagesJaunes Scraper: French Business Leads, Phones & SIRET", "description": "PagesJaunes scraper (Pages Jaunes, pagesjaunes.fr): French business leads by activity and city with full phone number, address, rating and website, plus SIRET, NAF, legal form, hours and GPS. Excel and CSV export. French proxies included.", "version": "0.1", "x-build-id": "P9Eu6uxFk6jSuGtzd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/firsthand~pagesjaunes-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-firsthand-pagesjaunes-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/firsthand~pagesjaunes-scraper/runs": { "post": { "operationId": "runs-sync-firsthand-pagesjaunes-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/firsthand~pagesjaunes-scraper/run-sync": { "post": { "operationId": "run-sync-firsthand-pagesjaunes-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQueries": { "title": "What (activity or business name)", "type": "array", "description": "What you would type in the PagesJaunes 'Quoi, qui' box, for example 'plombier', 'restaurant' or a company name.", "items": { "type": "string" } }, "locations": { "title": "Where (city, department or postal code)", "type": "array", "description": "Cities, departments or postal codes, for example 'Lyon', 'Gironde' or '33000'. Every query runs in every place. A place is required for queries.", "items": { "type": "string" } }, "startUrls": { "title": "PagesJaunes links", "type": "array", "description": "Search pages (https://www.pagesjaunes.fr/annuaire/chercherlespros?quoiqui=plombier&ou=paris), listing pages (https://www.pagesjaunes.fr/annuaire/paris-75/plombiers) or company pages (https://www.pagesjaunes.fr/pros/12345678).", "items": { "type": "string" } }, "includeDetails": { "title": "Add SIRET, NAF, website, hours and GPS", "type": "boolean", "description": "Opens each company page for SIRET and SIREN, NAF code, legal form, creation date, website, every phone number, opening hours, latitude and longitude. Charged once per business." }, "enrichWebsite": { "title": "Visit company website: emails, social links and VAT number", "type": "boolean", "description": "Opens the company's own website (home page plus up to 5 pages: contact, imprint, about, team) and adds the emails found there, social profile links and the TVA intracommunautaire number. The main email column is filled from the website when the directory has none. Charged once per business, only when the website gave at least one of these. Websites are visited without a proxy." }, "maxItems": { "title": "Max businesses", "minimum": 0, "type": "integer", "description": "Businesses in total across all queries, places and links. 100 if empty, 0 means no limit." }, "maxItemsPerQuery": { "title": "Max businesses per query and place", "minimum": 0, "type": "integer", "description": "Limit for each query in each place and for each link. Empty or 0 means no limit." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "PagesJaunes answers only French addresses. By default the Actor uses Apify residential proxies in France; the proxy cost is included in the price." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }