{ "openapi": "3.0.1", "info": { "title": "Sección Amarilla Scraper - Mexico Business Leads & Emails", "description": "Scrape Sección Amarilla, Mexico's yellow pages, by category or keyword in any state, city, neighborhood or postal code. Get phones, WhatsApp, emails, websites, address with postal code and GPS, plus opening hours, services, payment methods and social links. Export CSV, Excel or JSON.", "version": "1.0", "x-build-id": "jWMjLCOW2i0Zbmx68" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~seccionamarilla-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-seccionamarilla-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~seccionamarilla-scraper/runs": { "post": { "operationId": "runs-sync-normdata-seccionamarilla-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~seccionamarilla-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-seccionamarilla-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 \"abogados\", \"dentistas\" or \"taller mecánico\". Each term is searched separately. Spanish words find the most.", "items": { "type": "string" } }, "locations": { "title": "Places", "type": "array", "description": "Optional. Search only in these places: a state (\"Jalisco\", \"CDMX\"), city (\"Monterrey\"), neighborhood (\"Polanco\") or postal code (\"44100\"). Each place is searched with each term. Empty = all of Mexico.", "items": { "type": "string" } }, "includeDetails": { "title": "Business details (hours, services, social links)", "type": "boolean", "description": "Also read each advertiser's business page for its photo, description, opening hours, services, payment methods, every phone and WhatsApp, and Facebook, Instagram, LinkedIn, YouTube, X and TikTok links. Charged per business as an add-on (free listings have no page and are not charged)." }, "onlyCloseMatches": { "title": "Only close matches", "type": "boolean", "description": "Keep only businesses whose name or category has your search words, and that are in the state and city you chose (the site also shows nearby towns and related categories)." }, "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." }, "onlyWithAddress": { "title": "Only with street address", "type": "boolean", "description": "Keep only businesses that show their street address." }, "onlyAdvertisers": { "title": "Only advertisers", "type": "boolean", "description": "Keep only paid listings with their own business page. These usually have email, WhatsApp, website and opening hours." }, "postalCodes": { "title": "Postal codes", "type": "array", "description": "Keep only businesses whose postal code starts with one of these, like \"44100\" (one code) or \"441\" (every code starting with 441).", "items": { "type": "string" } }, "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": "Results pages (https://www.seccionamarilla.com.mx/resultados/abogados/jalisco/guadalajara/1) or business pages (https://www.seccionamarilla.com.mx/informacion/...).", "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 } } } } } } } } } }