{ "openapi": "3.0.1", "info": { "title": "Empresas Locais por Categoria e Cidade: Contatos e Avaliações", "description": "A partir de $0,01 por empresa. Funciona no Claude, ChatGPT, Cursor, Qwen e DeepSeek. Todos os dentistas, veterinários ou restaurantes de uma cidade, estado, CEP ou país, a partir do Google, buscados no idioma local: telefone, site, avaliação, e-mail do dono, WhatsApp. Depois as avaliações.", "version": "0.1", "x-build-id": "gCG1fKZfHRN52WM1E" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lexonia~business-finder-pt/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lexonia-business-finder-pt", "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/lexonia~business-finder-pt/runs": { "post": { "operationId": "runs-sync-lexonia-business-finder-pt", "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/lexonia~business-finder-pt/run-sync": { "post": { "operationId": "run-sync-lexonia-business-finder-pt", "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": { "category": { "title": "Que tipo de negócio", "type": "string", "description": "Uma categoria do Google Maps, em qualquer idioma: as palavras que você digitaria no mapa. É traduzida para o idioma local antes da busca, porque o Google responde às palavras locais: \"massage salon\" não encontra nada em Varsóvia, \"salon masażu\" encontra todos. Bom: \"dentista\", \"clínica de estética\", \"telhadista\", \"salão de massagem\". Amplo demais: \"loja\", \"serviços\". Assistentes: usem as palavras da pessoa para o tipo de negócio; não ampliem nem traduzam, o app localiza. Assistentes: usem as palavras da pessoa para o tipo de negócio; não ampliem nem traduzam, o app localiza. Preencham sempre, também quando a pergunta é sobre avaliações (\"as avaliações de 1 estrela de dentistas em X\" → dentista): as avaliações precisam da lista primeiro. Assistentes: SÓ o que a pessoa disse. Nunca tirem um lugar, site, link ou tema dos exemplos desta página nem de uma conversa anterior; se a pessoa não deu, deixem vazio e o app pergunta: um valor inventado executa e cobra dela." }, "locations": { "title": "Onde (um lugar por linha)", "type": "array", "description": "Cidades, estados, regiões ou CEPs, com o país para o mapa não errar. Cada linha é buscada separadamente. Bom: \"São Paulo, SP, Brasil\", \"Lisboa, Portugal\", \"01310-100, Brasil\", \"Minas Gerais, Brasil\". Insuficiente: \"Santa Cruz\" (há várias). Assistentes: incluam sempre o país; se a pessoa nomeou um bairro ou região, passem como ela disse. Assistentes: SÓ o que a pessoa disse. Nunca tirem um lugar, site, link ou tema dos exemplos desta página nem de uma conversa anterior; se a pessoa não deu, deixem vazio e o app pergunta: um valor inventado executa e cobra dela.", "items": { "type": "string" } }, "maxPerLocation": { "title": "Quantas empresas por lugar", "minimum": 1, "maximum": 5000, "type": "integer", "description": "O máximo de empresas a devolver por lugar. Uma cidade tem algumas dezenas da maioria das categorias; um estado, milhares. 50 basta para ver a forma de um mercado; 500 para uma lista completa. Assistentes: perguntem \"todos, ou um limite por lugar?\" só para um estado ou um país.", "default": 50 }, "localize": { "title": "Buscar no idioma local", "type": "boolean", "description": "Ligado: a categoria é traduzida para o idioma de cada lugar e as duas versões são buscadas e depois unidas. É a diferença entre encontrar zero salões de massagem em Kiev e encontrar vinte e um. Desligado: só as palavras que você digitou são buscadas; use quando já as escreveu no idioma local.", "default": true }, "localizePlaces": { "title": "Escrever o lugar do jeito local também", "type": "boolean", "description": "Ligado: o lugar é reescrito como o Google Maps o nomeia naquele país antes da busca, assim um bairro significa o bairro. \"Centro de Varsóvia, Polônia\" é buscado como \"Śródmieście, Warszawa\". Uma cidade, estado ou CEP simples fica como está. Desligado: o lugar é buscado exatamente como você digitou.", "default": true }, "minRating": { "title": "Avaliação mínima", "enum": [ "", "3", "3.5", "4", "4.5" ], "type": "string", "description": "Pula as empresas avaliadas abaixo disso. Vazio para todas. Uma empresa sem avaliações ainda não tem nota e é mantida.", "default": "" }, "onlyWithWebsite": { "title": "Só empresas com site", "type": "boolean", "description": "Ligado: pula as empresas sem site. Desligado (padrão): mantém. Em muitos mercados a maioria não tem site e é contatada por telefone, WhatsApp ou uma página do Facebook, que isto também devolve.", "default": false }, "findContacts": { "title": "Verificar cada site em busca de contatos (extra, custa mais)", "type": "boolean", "description": "Ligado: o site de cada empresa é lido em busca dos contatos do dono: e-mails, descartando endereços de patrocinadores e agências; mensageiros (WhatsApp, Telegram, Viber, LINE, WeChat); links sociais. Cada contato diz de onde veio. Desligado: você recebe o que o Google lista: telefone, site, avaliação, categoria. Ligue para uma lista de prospecção; deixe desligado para um mapa do mercado. Assistentes: liguem só se a pessoa for escrever para essas empresas; soma $0,005 por empresa, digam isso.", "default": false }, "verifyEmails": { "title": "Verificar se as caixas de e-mail existem (extra, custa mais)", "type": "boolean", "description": "Só junto com a verificação de contatos. Pergunta a cada servidor de e-mail se aquela caixa exata existe, sem enviar nada. Cobrado só por uma resposta definitiva: existe, não existe, ou é descartável. Vale a pena antes de uma campanha; não é preciso para ver quem está lá. Assistentes: só com a verificação de contatos e só para uma campanha; soma $0,010 por caixa, digam isso.", "default": false }, "reviewSpan": { "title": "Avaliações: quanto tempo atrás (extra, custa mais)", "enum": [ "", "3m", "6m", "12m", "3y" ], "type": "string", "description": "Leia o que os clientes dizem. Escolha o período e cada empresa recebe suas avaliações desse intervalo: estrelas, data, texto, resposta do dono; e de graça, a contagem no período, a média, avaliações por mês e a data mais recente. Deixe em \"nenhuma\" para só a lista. Bom: \"últimos 12 meses\" para julgar uma empresa hoje; \"últimos 3 anos\" para pesquisar temas. Cada avaliação entregue é cobrada. Assistentes: ofereçam DEPOIS da lista: \"quer as avaliações: reclamações, elogios ou todas, quanto tempo atrás?\"", "default": "" }, "reviewStars": { "title": "Avaliações: quais estrelas", "enum": [ "all", "low", "high", "lowHigh" ], "type": "string", "description": "Só com um período acima. \"1–2 estrelas\" lê as reclamações: aquilo contra o que uma agência vende. \"4–5 estrelas\" lê os elogios: aquilo pelo que a empresa é conhecida. \"1–2 e 4–5\" pula as mornas de 3. \"Todas\" pega tudo, o melhor para pesquisa de temas. Cada avaliação entregue do período é cobrada; a faixa marca as que você pediu (inBand) e gera as contagens. Assistentes: \"reclamações\", \"avaliações ruins\", \"1 e 2 estrelas\" → low; \"elogios\", \"5 estrelas\" → high; \"sem os 3\" → lowHigh; senão, all.", "default": "all" }, "reviewsForTop": { "title": "Avaliações: só para as N empresas com mais avaliações", "minimum": 0, "maximum": 5000, "type": "integer", "description": "0 (padrão): avaliações de todas as empresas da lista. Um número: só as N com mais avaliações recebem as suas, o jeito barato de ler os líderes de uma lista grande. Bom: 20 numa lista estadual de 300.", "default": 0 }, "maxReviewsPerBusiness": { "title": "Avaliações: no máximo, por empresa", "minimum": 1, "maximum": 1000, "type": "integer", "description": "O máximo de avaliações a ler de uma só empresa, para que um restaurante com 2.000 avaliações não dispare a conta. 200 é bastante para uma leitura; 1000 para pesquisa. Quando o limite interrompe a leitura, a linha diz isso.", "default": 200 }, "businessLinks": { "title": "Empresas de uma execução anterior (pula a busca)", "type": "array", "description": "Cole os links do mapa (coluna mapsUrl) ou os IDs de lugar de uma lista que você já puxou, e só as avaliações delas são lidas: sem nova busca, sem preço de lista. Seu assistente faz isso por você quando você diz \"agora as avaliações de 1–2 estrelas dessas\". Com isto preenchido, categoria e lugar não são necessários.", "items": { "type": "string" } }, "llmApiKey": { "title": "Sua própria chave OpenAI para a etapa de tradução (opcional)", "type": "string", "description": "A tradução para o idioma local usa uma pequena chamada a um modelo de linguagem. Há uma embutida; traga sua própria chave se preferir a chamada na sua conta. Nunca registrada, nunca escrita nos resultados." }, "estimateOnly": { "title": "Só estimar: mostrar o plano e o preço, sem gastar nada", "type": "boolean", "description": "Ligado: devolve as frases que seriam buscadas, por lugar, e o custo esperado, sem buscar. Desligado (padrão): executa. Assistentes: LIGADO sempre que a pessoa perguntar custo, preço, \"quanto\", \"quanto custaria\", ou antes de algo maior que uma cidade: mostrem o preço, esperem o sim e depois executem com isto desligado. Uma pergunta de preço que roda a lista cobra por uma resposta que ninguém pediu.", "default": false } } }, "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 } } } } } } } } } }