{ "openapi": "3.0.1", "info": { "title": "Lead Extractor-Google Map", "description": "Lead Extractor is an automation tool that extracts business leads and contact details from Google Map. Instantly collect company names, phone numbers, and more for easy export and outreach. Perfect for sales, marketing, and lead generation.", "version": "0.0", "x-build-id": "qZqksPmTLe00bE6yG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/happitap~lead-extractor-google-map/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-happitap-lead-extractor-google-map", "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/happitap~lead-extractor-google-map/runs": { "post": { "operationId": "runs-sync-happitap-lead-extractor-google-map", "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/happitap~lead-extractor-google-map/run-sync": { "post": { "operationId": "run-sync-happitap-lead-extractor-google-map", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "List of URLs to extract business leads from. Supports Google Maps search URLs (e.g., https://www.google.com/maps/search/salon+Mumbai/), Yellow Pages URLs (e.g., https://www.yellowpages.com/search?search_terms=restaurant&geo_location_terms=New+York), and JustDial URLs (e.g., https://www.justdial.com/Mumbai/Restaurants). Each URL should be a search results page for the type of businesses you want to extract. The Actor will automatically detect the source and use the appropriate extraction logic. Format: Array of objects with 'url' property. Required to specify where to scrape leads from.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxLeads": { "title": "Maximum Leads per URL", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of business leads to extract from each start URL. This limits how many results the Actor will scrape to control runtime and costs. For example, setting this to 50 will extract up to 50 businesses from each URL in the startUrls list. Default: 100. Format: Positive integer. Why needed: Prevents excessive scraping and helps manage Actor runtime costs.", "default": 100 }, "concurrency": { "title": "Concurrency (Parallel Processing)", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of business detail pages to process in parallel. Higher values speed up extraction but use more resources and may trigger rate limiting or timeouts. Recommended: 3-5 for reliable extraction. Values above 10 are capped to 10 to prevent resource overload. Lower values (3-5) are safer and more reliable. Default: 5. Format: Positive integer between 1-10. Why needed: Controls extraction speed and resource usage to balance performance with reliability.", "default": 5 }, "timeoutSecs": { "title": "Timeout (seconds)", "minimum": 30, "maximum": 600, "type": "integer", "description": "Maximum time the Actor will run before gracefully stopping and returning partial results. Capped at 270s (4.5 minutes) to leave a 30s safety buffer before Apify's default 5-minute platform timeout. If you have increased your Actor's platform timeout in Apify settings, you can raise this value accordingly (it will still be capped at 270s internally). Default: 300. Format: Positive integer in seconds.", "default": 300 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings to avoid IP blocking and rate limiting. Using proxies is essential for scraping Google Maps, Yellow Pages, and JustDial as these sites may block requests from the same IP. Recommended: Use Apify's residential proxies for best results. Format: Proxy configuration object with 'useApifyProxy' set to true. Why needed: Ensures reliable scraping without getting blocked by target websites.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }