{
"openapi": "3.0.1",
"info": {
"title": "Paginasamarillas Scraper | Business Leads, Emails and Phones",
"description": "Páginas Amarillas scraper for Spain (paginasamarillas.es). Search by keyword and city, results link or business ID and get business leads with phone, email, website, social links, full address, GPS and opening hours by day. 10 businesses in 31 seconds, 69 fields each. No login or account needed.",
"version": "1.0",
"x-build-id": "ugD24LqiYog877EJK"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~paginasamarillas-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-paginasamarillas-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/silentflow~paginasamarillas-scraper/runs": {
"post": {
"operationId": "runs-sync-silentflow-paginasamarillas-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/silentflow~paginasamarillas-scraper/run-sync": {
"post": {
"operationId": "run-sync-silentflow-paginasamarillas-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": {
"keywords": {
"title": "🔎 Keywords",
"type": "array",
"description": "What you would type in the Páginas Amarillas search box: a trade or business type (restaurantes, fontaneros, abogados, clínica dental) or a business name. Spanish words match best. Each keyword runs its own search; restaurantes in Madrid lists about 3,500 businesses.",
"items": {
"type": "string"
}
},
"location": {
"title": "📍 Location",
"type": "string",
"description": "City, town, province or postal code in Spain for the keywords (Madrid, Barcelona, Valencia, 28001). Leave empty to search all of Spain."
},
"startUrls": {
"title": "🔗 Páginas Amarillas URLs",
"type": "array",
"description": "Paste links from paginasamarillas.es: a results page (https://www.paginasamarillas.es/search/fontaneros/all-ma/madrid/all-is/madrid/all-ba/all-pu/all-nc/1), with every page after it, or a business page (https://www.paginasamarillas.es/f/madrid/sol-azteca_234567139_000000001.html).",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"businessIds": {
"title": "🆔 Business IDs",
"type": "array",
"description": "Listing codes, the part after the last underscore of a business link (234567139_000000001 or 8DdsfCdjkf). Each returns that business in full. Paste one per line, or several separated by commas.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "🔢 Max businesses",
"minimum": 1,
"type": "integer",
"description": "How many businesses to save in total, across all keywords, links and IDs. The run stops there. With full details on, expect about 15 to 20 businesses a minute.",
"default": 100
},
"onlyWithEmail": {
"title": "📧 Only businesses with an email",
"type": "boolean",
"description": "Save only businesses that publish an email address. Ideal for email outreach lists.",
"default": false
},
"onlyWithWebsite": {
"title": "🌐 Only businesses with a website",
"type": "boolean",
"description": "Save only businesses that publish a website.",
"default": false
},
"onlyPaidListings": {
"title": "⭐ Only paid listings",
"type": "boolean",
"description": "Save only advertisers with a paid listing. They usually carry a logo, a longer description, years on Páginas Amarillas and more contact channels.",
"default": false
},
"includeDetails": {
"title": "📄 Full business details",
"type": "boolean",
"description": "On: each row carries the whole business page: email, every phone, social links, WhatsApp, opening hours day by day, services, brands, payment methods, price, company register data, branches and nearby places. Off: a faster run with the search data only (name, category, phone, address, coordinates, website).",
"default": true
}
}
},
"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
}
}
}
}
}
}
}
}
}
}