{ "openapi": "3.0.1", "info": { "title": "Google Ads Scraper - Anúncios Patrocinados por Palavra-chave", "description": "Busque anúncios patrocinados no Google por palavra-chave e região com este Google Ads API Scraper. Consulte resultados no Brasil por estado e dispositivo e exporte posição, título, anunciante, descrição, domínio, links e extensões em JSON, CSV ou Excel para análise de concorrentes e tráfego pago.", "version": "0.1", "x-build-id": "OZkxlOsX2bA3q3Y1d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brasildados~google-ads-palavras-chave-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brasildados-google-ads-palavras-chave-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/brasildados~google-ads-palavras-chave-scraper/runs": { "post": { "operationId": "runs-sync-brasildados-google-ads-palavras-chave-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/brasildados~google-ads-palavras-chave-scraper/run-sync": { "post": { "operationId": "run-sync-brasildados-google-ads-palavras-chave-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", "required": [ "query" ], "properties": { "query": { "title": "Palavra-chave", "minLength": 2, "type": "string", "description": "Termo que uma pessoa pesquisaria no Google. Exemplos: contabilidade online, seguro auto ou curso de inglês.", "default": "contabilidade online" }, "location": { "title": "Região da pesquisa", "enum": [ "Brazil", "State of Acre,Brazil", "State of Alagoas,Brazil", "State of Amapa,Brazil", "State of Amazonas,Brazil", "State of Bahia,Brazil", "State of Ceara,Brazil", "Federal District,Brazil", "State of Espirito Santo,Brazil", "State of Goias,Brazil", "State of Maranhao,Brazil", "State of Mato Grosso,Brazil", "State of Mato Grosso do Sul,Brazil", "State of Minas Gerais,Brazil", "State of Para,Brazil", "State of Paraiba,Brazil", "State of Parana,Brazil", "State of Pernambuco,Brazil", "State of Piaui,Brazil", "State of Rio de Janeiro,Brazil", "State of Rio Grande do Norte,Brazil", "State of Rio Grande do Sul,Brazil", "State of Rondonia,Brazil", "State of Roraima,Brazil", "State of Santa Catarina,Brazil", "State of Sao Paulo,Brazil", "State of Sergipe,Brazil", "State of Tocantins,Brazil" ], "type": "string", "description": "Opcional. Use Brasil para uma pesquisa nacional ou selecione um estado para observar anúncios regionais.", "default": "Brazil" }, "device": { "title": "Dispositivo", "enum": [ "desktop", "mobile", "tablet" ], "type": "string", "description": "Opcional. Os anúncios podem mudar conforme o dispositivo usado na pesquisa.", "default": "desktop" }, "maxResults": { "title": "Quantidade máxima de anúncios", "minimum": 1, "maximum": 20, "type": "integer", "description": "Opcional. Limite de anúncios entregues e cobrados nesta pesquisa.", "default": 20 } } }, "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 } } }, "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 } } } } } } } } } }