{ "openapi": "3.0.1", "info": { "title": "Paginasamarillas Scraper", "description": "Search Paginas Amarillas across 8 Latin American countries for B2B leads: phone, WhatsApp, email, website, address and coordinates. Real per-day hours with split shifts, an open-right-now filter, minimum-rating filtering, and full branch and social data other scrapers don't expose.", "version": "1.0", "x-build-id": "S7HWuwrRJNQVuyXDU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~paginasamarillas-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-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/normdata~paginasamarillas-scraper/runs": { "post": { "operationId": "runs-sync-normdata-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/normdata~paginasamarillas-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-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": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many businesses in total. Leave empty for no limit. The Apify Free plan is always capped at 10." }, "searchTerms": { "title": "Search terms", "type": "array", "description": "What to search, as you would on the site: a category, product or business name, like \"restaurantes\", \"abogados\" or \"ferreteria\". Each term is searched separately. Spanish words find the most.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Which Paginas Amarillas sites to search. Empty = Colombia. Businesses the site lists from a neighboring country are left out.", "items": { "type": "string", "enum": [ "co", "pe", "ar", "cl", "gt", "sv", "ni", "pa" ], "enumTitles": [ "Colombia", "Perú", "Argentina", "Chile", "Guatemala", "El Salvador", "Nicaragua", "Panamá" ] } }, "locations": { "title": "Cities or regions", "type": "array", "description": "Optional. Search only in these places, like \"Medellín\", \"Lima\" or \"Antioquia\". Each place is searched with each term. Empty = the whole country.", "items": { "type": "string" } }, "includeDetails": { "title": "Business details (opening hours, services, rating)", "type": "boolean", "description": "Also read each business page for its opening hours, services, keywords, products, videos, rating and a customer review. Charged per business as an add-on." }, "onlyCloseMatches": { "title": "Only close matches", "type": "boolean", "description": "The site also shows paid ads from other categories and other cities. Keep only businesses whose name or description has your search words, and that are in the city or region you chose." }, "onlyWithEmail": { "title": "Only with email", "type": "boolean", "description": "Keep only businesses that list an email address." }, "onlyWithPhone": { "title": "Only with phone", "type": "boolean", "description": "Keep only businesses that list a phone number." }, "onlyWithWhatsapp": { "title": "Only with WhatsApp", "type": "boolean", "description": "Keep only businesses that list a WhatsApp number." }, "onlyWithWebsite": { "title": "Only with website", "type": "boolean", "description": "Keep only businesses that list a website." }, "onlyWithSocial": { "title": "Only with social media", "type": "boolean", "description": "Keep only businesses that link a Facebook, Instagram, LinkedIn, YouTube, X or TikTok page." }, "onlyPremium": { "title": "Only premium listings", "type": "boolean", "description": "Keep only businesses with a premium (top paid) listing. These usually have the most complete contact data." }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Keep only businesses rated at least this much (1 to 5). Turns on business details." }, "openOn": { "title": "Open on these days", "type": "array", "description": "Keep only businesses whose published hours include every chosen day. Turns on business details.", "items": { "type": "string", "enum": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ], "enumTitles": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ] } }, "onlyNew": { "title": "Only new businesses", "type": "boolean", "description": "Skip businesses saved by earlier runs with the same monitor name." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Runs with the same name share their history. Use a different name for each schedule." }, "startUrls": { "title": "Links", "type": "array", "description": "Business pages (https://www.paginasamarillas.com.co/empresas/...) or search pages (https://www.paginasamarillas.com.co/medellin/servicios/restaurantes) from any of the 8 country sites.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }