{ "openapi": "3.0.1", "info": { "title": "ACCA Accountancy Firms Scraper: Email, Phone & Address", "description": "Scrape the ACCA Find an Accountant directory for registered accountancy firms worldwide. Get firm name, full address, phone, EMAIL, website, sector expertise, services offered and named firm partners. Search by country, city or firm name. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "e3vSfPaGiJs0rLHtq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~acca-accountants-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-acca-accountants-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/scrapers_lat~acca-accountants-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-acca-accountants-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/scrapers_lat~acca-accountants-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-acca-accountants-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": { "isoCountry": { "title": "Country (ISO code)", "type": "string", "description": "Two-letter ISO country code to search within the ACCA firm directory, for example GB (United Kingdom), IE (Ireland), CY (Cyprus), SG (Singapore), MY (Malaysia), AE (United Arab Emirates), ZW (Zimbabwe), PK (Pakistan)." }, "locations": { "title": "Cities / towns to search", "type": "array", "description": "One or more city, town or postcode search terms. Each runs a separate search and results are combined. Leave empty if you search by firm name instead.", "items": { "type": "string" } }, "firmName": { "title": "Firm name (optional)", "type": "string", "description": "Optional. Only return firms whose name contains this text (for example 'accountancy', 'smith'). Can be combined with cities, or used on its own." }, "fetchDetails": { "title": "Fetch full firm details", "type": "boolean", "description": "When enabled, each firm is enriched with its sector expertise, services offered and named firm partners from its detail page. Disable for a faster, contacts-only run.", "default": true }, "maxFirms": { "title": "Max Firms To Scrape", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of firms to collect across all searches." }, "sector": { "title": "Sector filter code (advanced, optional)", "type": "string", "description": "Optional advanced filter: ACCA sector-expertise code to restrict results." }, "service": { "title": "Service filter code (advanced, optional)", "type": "string", "description": "Optional advanced filter: ACCA services-offered code to restrict results." }, "certificate": { "title": "Certificate filter code (advanced, optional)", "type": "string", "description": "Optional advanced filter: ACCA certificate/licence code (for example audit or investment business)." }, "withLeadScore": { "title": "AI lead score (paid add-on)", "type": "boolean", "description": "Use AI to qualify each firm as a B2B outreach lead (0-100 score, hot/warm/cold tier, rationale). Charged per firm scored. Paid plans only.", "default": false }, "withProfileSummary": { "title": "AI profile summary (paid add-on)", "type": "boolean", "description": "Use AI to write a concise business summary of each firm. Charged per firm summarised. Paid plans only.", "default": false }, "withIndustry": { "title": "AI industry / categorisation (paid add-on)", "type": "boolean", "description": "Use AI to classify each firm's primary specialism and service/sector tags. Charged per firm classified. Paid plans only.", "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 } } }, "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 } } } } } } } } } }