# Xero & QuickBooks Accounting Firm Leads (`obliging_persimmon_cki/xero-quickbooks-accounting-firm-leads`) Actor Find and normalize public Xero and QuickBooks accounting advisor profiles in London. - **URL**: https://apify.com/obliging\_persimmon\_cki/xero-quickbooks-accounting-firm-leads.md - **Developed by:** [Dung Huynh](https://apify.com/obliging_persimmon_cki) (community) - **Categories:** Lead generation, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## London Xero & QuickBooks Accounting Firm Leads Find and normalize public accounting firm and advisor profiles from the Xero and QuickBooks directories in London, United Kingdom. The Actor is designed for accounting-software sales, fintech prospecting, partner research, recruitment, and market analysis. ### Current checkpoint The Xero and QuickBooks adapters are live public-directory implementations. The location is fixed to London, United Kingdom and resolves to UK-specific routes: Xero parses the server-rendered advisor data and visits public profiles, while QuickBooks drives its JavaScript search UI and public GraphQL-backed results. Website enrichment is unavailable. ### Input Use [sample-input.json](sample-input.json): ```json { "sources": ["xero", "quickbooks"], "maxResults": 14, "extractContacts": false, "includeRawData": false, "proxyConfiguration": { "useApifyProxy": false } } ```` The Actor always searches London, United Kingdom; there is no public location input. Legacy API payloads that include `locations` are ignored and canonicalized to London. The Actor returns at most `maxResults` (1–5,000) final deduplicated leads. When both Xero and QuickBooks are selected, a `maxResults` value below 14 is automatically normalized to 14 so both directories can contribute; single-source runs use the configured value unchanged. `enrichWebsites: true` is rejected because website enrichment is unavailable. ### Output fields | Field | Type | Description | | ---------------------- | -------------- | ------------------------------------------------ | | `firmName` | string | Normalized public firm or advisor name | | `primaryCountry` | string or null | Convenience value from the first public location | | `primaryCity` | string or null | Convenience value from the first public location | | `website` | string or null | Website published by the public directory | | `primaryEmail` | string or null | First public business email | | `primaryPhone` | string or null | First public business phone | | `services` | string\[] | Stable English machine-readable service IDs | | `industriesServed` | string\[] | Stable English machine-readable industry IDs | | `hasXeroProfile` | boolean | Whether Xero provenance exists | | `hasQuickBooksProfile` | boolean | Whether QuickBooks provenance exists | | `completenessScore` | integer | Deterministic data completeness from 0–100 | | `scrapedAt` | string | ISO timestamp | Full records also retain advisor names, firm types, locations, emails with sources, contacts, social links, software relationships, languages, descriptions, source records, and optional compact raw data. The completeness formula awards: firm name 5, directory profile 10, website/domain 15, public email 15, public phone 10, full location 10, service 10, industry 5, certification/specialty 10, contact person 5, and description 5. ### Local checks ```bash npm install npm run lint npm test npm run build apify validate-schema ``` Both sources have passed independent London live runs with directory items and profiles fetched. Website enrichment is unavailable, so these are directory-only results. Source diagnostics report the source, location, stage, sanitized requested URL, HTTP status, content type, response size when available, parsed-item count, and sanitized error. They never include cookies, tokens, full HTML, or sensitive headers. ### Limitations and responsible use Coverage and fields are limited to what the London, United Kingdom directory routes publish. Xero's UK city page currently exposes five featured advisors; its full-results link returns 404. QuickBooks currently parses the first rendered result page; cursor pagination is not implemented. The QuickBooks UK directory requires JavaScript/browser interaction, a UK region parameter, a city-only location term, and a short debounced search wait; no cookie acceptance, authentication, or CAPTCHA bypass was required. Website enrichment is unavailable. The Actor processes public business data only, does not bypass authentication or CAPTCHA, does not guess emails, and does not infer certifications without explicit source evidence. Users must comply with applicable platform terms, privacy rules, and marketing laws. ### Tiếng Việt Actor chuẩn hóa hồ sơ công khai của công ty kế toán và chuyên gia tại London, United Kingdom từ danh bạ Xero và QuickBooks. Đây là đầu ra chỉ từ danh bạ; không có nhập địa điểm công khai và không có làm giàu website. Dữ liệu phân loại dùng ID tiếng Anh ổn định, còn nội dung gốc và nguồn dữ liệu được giữ lại. Không đoán email hoặc chứng chỉ; trường không chắc chắn được trả về `null` hoặc mảng rỗng. # Actor input Schema ## `sources` (type: `array`): Advisor directories to search. ## `maxResults` (type: `integer`): Maximum number of final deduplicated London leads. When both Xero and QuickBooks are selected, values below 14 are normalized to a combined-source floor of 14; single-source runs are unchanged. ## `extractContacts` (type: `boolean`): Extract publicly listed accounting-firm contacts. ## `includeRawData` (type: `boolean`): Include compact source fields for debugging. ## `proxyConfiguration` (type: `object`): Proxy settings for public directory requests. ## Actor input object example ```json { "sources": [ "xero", "quickbooks" ], "maxResults": 14, "extractContacts": false, "includeRawData": false, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `dataset` (type: `string`): Deduplicated London, United Kingdom accounting firms with Xero and QuickBooks source provenance. ## `summary` (type: `string`): Normalized effective London input plus directory search, profile, result, and source-failure counters. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("obliging_persimmon_cki/xero-quickbooks-accounting-firm-leads").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("obliging_persimmon_cki/xero-quickbooks-accounting-firm-leads").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call obliging_persimmon_cki/xero-quickbooks-accounting-firm-leads --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=obliging_persimmon_cki/xero-quickbooks-accounting-firm-leads", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Xero & QuickBooks Accounting Firm Leads", "description": "Find and normalize public Xero and QuickBooks accounting advisor profiles in London.", "version": "0.1", "x-build-id": "Bk60xEBqxkFagtmx6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/obliging_persimmon_cki~xero-quickbooks-accounting-firm-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-obliging_persimmon_cki-xero-quickbooks-accounting-firm-leads", "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/obliging_persimmon_cki~xero-quickbooks-accounting-firm-leads/runs": { "post": { "operationId": "runs-sync-obliging_persimmon_cki-xero-quickbooks-accounting-firm-leads", "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/obliging_persimmon_cki~xero-quickbooks-accounting-firm-leads/run-sync": { "post": { "operationId": "run-sync-obliging_persimmon_cki-xero-quickbooks-accounting-firm-leads", "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": { "sources": { "title": "Sources", "uniqueItems": true, "type": "array", "description": "Advisor directories to search.", "items": { "type": "string", "enum": [ "xero", "quickbooks" ], "enumTitles": [ "Xero Advisor Directory", "QuickBooks ProAdvisor Directory" ] }, "default": [ "xero", "quickbooks" ] }, "maxResults": { "title": "Maximum leads", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of final deduplicated London leads. When both Xero and QuickBooks are selected, values below 14 are normalized to a combined-source floor of 14; single-source runs are unchanged.", "default": 14 }, "extractContacts": { "title": "Extract public contact people", "type": "boolean", "description": "Extract publicly listed accounting-firm contacts.", "default": false }, "includeRawData": { "title": "Include raw source data", "type": "boolean", "description": "Include compact source fields for debugging.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings for public directory requests.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```