{ "openapi": "3.0.1", "info": { "title": "PagineGialle Italy Scraper", "description": "[💰 $1.8 / 1K] Extract Italian business listings from PagineGialle.it — name, address, phone, website, email, category, rating, and geo. Search by what + where, filter by category, or paste PagineGialle URLs directly.", "version": "1.0", "x-build-id": "ZOHKSYKcNdn7CkJ0u" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~paginegialle-it-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-paginegialle-it-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/solidcode~paginegialle-it-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-paginegialle-it-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/solidcode~paginegialle-it-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-paginegialle-it-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 to search", "type": "array", "description": "What to look for on PagineGialle (e.g. 'ristoranti', 'idraulico', 'commercialista', 'parrucchiere', 'avvocato'). One row per search term. Each term is combined with every location below — for example 2 terms x 3 locations = 6 searches. Leave empty if you're using direct URLs.", "items": { "type": "string" } }, "locations": { "title": "Where to search", "type": "array", "description": "Where in Italy to search: a city, town, or province (e.g. 'Roma', 'Milano', 'Napoli', 'Torino'). One row per place. Each location is combined with every search term above. Leave empty to search all of Italy (nationwide) for each term.", "items": { "type": "string" } }, "startUrls": { "title": "PagineGialle URLs", "type": "array", "description": "Paste PagineGialle.it URLs directly: search-result pages (e.g. https://www.paginegialle.it/ricerca/ristoranti/roma) or individual business profile pages. Filters baked into the URL (zone, sort) are honored as-is. When provided, these are scraped in addition to any search terms above.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "any", "ristoranti", "alberghi", "bar-caffe", "negozi", "supermercati", "parrucchieri", "estetiste-centri-estetici", "palestre-fitness", "medici-specialisti", "dentisti", "farmacie", "avvocati", "commercialisti", "agenzie-immobiliari", "idraulici", "elettricisti", "imprese-edili", "autofficine", "officine-meccaniche", "carrozzerie", "assicurazioni", "banche", "scuole", "veterinari" ], "type": "string", "description": "Pick a ready-made business sector instead of typing your own search term. When set to anything other than 'Any category', the chosen sector becomes the search term and is combined with every location below (any terms you typed under 'What to search' are ignored for this run). Choose 'Any category' to use your own search terms instead.", "default": "any" }, "sort": { "title": "Sort results by", "enum": [ "relevance", "distance", "popularity" ], "type": "string", "description": "Order in which businesses are collected. 'Relevance' is the PagineGialle default; 'Nearest first' orders by distance from the searched location; 'Most popular' surfaces the most-viewed businesses first.", "default": "relevance" }, "maxResults": { "title": "Max results per search", "minimum": 0, "type": "integer", "description": "Maximum number of business listings to collect for each search (each what + where combination, and each URL). Default 100 — increase for bigger runs, or set to 0 for no cap (an internal upper limit of 10,000 per search still applies to prevent runaway pagination). The actor stops requesting new pages once this number is reached but keeps the full final page even if it slightly overshoots.", "default": 100 } } }, "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 } } }, "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 } } } } } } } } } }