{ "openapi": "3.0.1", "info": { "title": "Hotfrog Business Directory Scraper", "description": "[💰 $2.5 / 1K] Extract business listings from Hotfrog directories across 25+ countries — name, address, phone, website, email, coordinates, hours, categories, and social links. Search by category and city, browse cities, or paste profile URLs. Clean data for lead generation.", "version": "1.0", "x-build-id": "hEzeAMdQyEUfsY72N" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~hotfrog-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-hotfrog-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/solidcode~hotfrog-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-hotfrog-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/solidcode~hotfrog-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-hotfrog-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": { "searchTerms": { "title": "Categories / Search Terms", "type": "array", "description": "Business categories or keywords to look up (e.g. 'plumber', 'restaurant', 'dentist', 'accountant'). Each term is searched in every location below, so you can cover many categories in one run. Leave empty to browse every business in the chosen locations instead.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Cities or areas to search in (e.g. 'new-york', 'los-angeles', 'london', 'sydney'). Use hyphens for multi-word cities. Each location is combined with every search term above. Leave empty to search across the whole country.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "us", "gb", "au", "ca", "ie", "nz", "de", "fr", "es", "it", "nl", "at", "ch", "dk", "no", "pl", "pt", "in", "sg", "my", "za", "br", "mx", "ar", "jp", "hk", "ph" ], "type": "string", "description": "Which Hotfrog country directory to search. Each country has its own listings.", "default": "us" }, "startUrls": { "title": "Hotfrog URLs", "type": "array", "description": "Paste Hotfrog URLs directly from your browser — search result pages (e.g. https://www.hotfrog.com/find/plumber/new-york) or individual company profile pages (e.g. https://www.hotfrog.com/company/.../new-york/dental-care). When provided, the Country, Categories, and Locations above are ignored.", "items": { "type": "string" } }, "includeDetails": { "title": "Include full business details", "type": "boolean", "description": "When enabled, the actor opens each business's profile page to add the complete record — email (when published), exact GPS coordinates, full opening hours, long description, offers/deals, payment methods, and social links. Turn this off for a faster, lighter run that returns just the core fields visible on the results list (name, profile URL, category, and partial address).", "default": true }, "maxResults": { "title": "Maximum Results", "minimum": 0, "type": "integer", "description": "Hard cap on the total number of business listings collected across all searches and URLs. Default 100 — increase for bigger runs. A built-in safety ceiling of 50,000 results applies to every run: any higher value (including 0, which means 'collect as much as possible') is capped at 50,000. Each listing is billed at the per-result rate.", "default": 100 } } }, "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 } } } } } } } } } }