{ "openapi": "3.0.1", "info": { "title": "BuscJá Scraper - Brazil Business Leads (Telelistas)", "description": "Scrape Brazilian businesses from BuscJá (formerly Telelistas) by category or keyword in any city, neighborhood or state. Get phone, WhatsApp, website, address and category, plus postal code, map position, opening hours, services, payment methods and social links. Filters and monitoring.", "version": "1.0", "x-build-id": "cKRDvx51GSmoUh5df" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~buscja-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-buscja-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~buscja-scraper/runs": { "post": { "operationId": "runs-sync-normdata-buscja-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~buscja-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-buscja-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\", \"dentistas\" or \"oficina mecânica\". Each term is searched separately. Portuguese words find the most.", "items": { "type": "string" } }, "locations": { "title": "Places", "type": "array", "description": "Optional. Search only in these places: a city (\"Campinas\"), a neighborhood (\"Copacabana, Rio de Janeiro\") or a whole state (\"SP\" or \"Minas Gerais\", searched city by city, largest first). Each place is searched with each term. Empty = all of Brazil.", "items": { "type": "string" } }, "includeDetails": { "title": "Business details (postal code, hours, services, social links)", "type": "boolean", "description": "Also read each business page for its postal code, map position, every phone and WhatsApp, categories, services, payment methods, opening hours, photos, and Facebook, Instagram, LinkedIn, YouTube, X and TikTok links. Charged per business as an add-on." }, "onlyCloseMatches": { "title": "Only close matches", "type": "boolean", "description": "Keep only businesses whose name, category or description has your search words, and that are in the city or neighborhood you chose (the site also shows related categories)." }, "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." }, "onlyWithSocialMedia": { "title": "Only with social media", "type": "boolean", "description": "Keep only businesses that link a Facebook, Instagram, LinkedIn, YouTube, X or TikTok profile. Turns on business details." }, "postalCodes": { "title": "Postal codes (CEP)", "type": "array", "description": "Keep only businesses whose CEP starts with one of these, like \"01426-000\" (one CEP) or \"014\" (every CEP starting with 014). Turns on business details.", "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.buscja.com/sp/sao+paulo/restaurantes) or business pages (https://www.buscja.com/locais/...). Old Telelistas links work too.", "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 } } } } } } } } } }