{ "openapi": "3.0.1", "info": { "title": "Xero Advisors Scraper", "description": "Every Xero-certified accounting and bookkeeping firm in 86 countries: partner tier, phone, website, every office, badges and professional bodies. Emails from each firm's own site, 13 filters, search near any city, one row per firm or office, and alerts on new firms and tier changes.", "version": "1.0", "x-build-id": "KV2w5fdgpXtXxZTZS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~xero-advisors-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-xero-advisors-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/normdata~xero-advisors-scraper/runs": { "post": { "operationId": "runs-sync-normdata-xero-advisors-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/normdata~xero-advisors-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-xero-advisors-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": { "maxItems": { "title": "Maximum firms", "minimum": 1, "type": "integer", "description": "How many firms to return. 10 is a quick sample; clear it to get every match." }, "countries": { "title": "Countries", "type": "array", "description": "Pick one or more countries (the number is how many firms each has). Leave empty for all 86.", "items": { "type": "string", "enum": [ "AG", "AR", "AU", "AT", "BD", "BB", "BM", "BW", "VG", "BN", "BG", "KH", "CA", "KY", "CN", "CO", "CK", "CR", "CW", "CY", "EG", "EE", "FJ", "DE", "GH", "GI", "GG", "HK", "IS", "IN", "ID", "IE", "IM", "IL", "JM", "JP", "JE", "KE", "KW", "LS", "LI", "LU", "MY", "MV", "MT", "MU", "MX", "MN", "MM", "NA", "NP", "NL", "NZ", "NG", "NO", "PK", "PA", "PG", "PH", "PT", "PR", "QA", "RW", "WS", "SA", "SG", "SB", "ZA", "KR", "ES", "LK", "CH", "TW", "TZ", "TH", "TT", "TR", "UG", "AE", "GB", "US", "VU", "VE", "VN", "ZM", "ZW" ], "enumTitles": [ "Antigua & Barbuda (1)", "Argentina (1)", "Australia (5,987)", "Austria (1)", "Bangladesh (4)", "Barbados (4)", "Bermuda (2)", "Botswana (5)", "British Virgin Islands (1)", "Brunei (1)", "Bulgaria (1)", "Cambodia (5)", "Canada (241)", "Cayman Islands (5)", "China (9)", "Colombia (1)", "Cook Islands (2)", "Costa Rica (3)", "Curaçao (1)", "Cyprus (6)", "Egypt (1)", "Estonia (1)", "Fiji (8)", "Germany (2)", "Ghana (9)", "Gibraltar (5)", "Guernsey (6)", "Hong Kong SAR China (90)", "Iceland (1)", "India (22)", "Indonesia (26)", "Ireland (123)", "Isle of Man (7)", "Israel (2)", "Jamaica (1)", "Japan (5)", "Jersey (13)", "Kenya (7)", "Kuwait (11)", "Lesotho (1)", "Liechtenstein (1)", "Luxembourg (3)", "Malaysia (80)", "Maldives (4)", "Malta (25)", "Mauritius (6)", "Mexico (2)", "Mongolia (1)", "Myanmar (Burma) (7)", "Namibia (11)", "Nepal (1)", "Netherlands (10)", "New Zealand (1,490)", "Nigeria (3)", "Norway (1)", "Pakistan (12)", "Panama (1)", "Papua New Guinea (4)", "Philippines (44)", "Portugal (1)", "Puerto Rico (1)", "Qatar (3)", "Rwanda (2)", "Samoa (3)", "Saudi Arabia (7)", "Singapore (267)", "Solomon Islands (1)", "South Africa (532)", "South Korea (1)", "Spain (5)", "Sri Lanka (17)", "Switzerland (7)", "Taiwan (1)", "Tanzania (2)", "Thailand (16)", "Trinidad & Tobago (3)", "Türkiye (1)", "Uganda (2)", "United Arab Emirates (54)", "United Kingdom (4,842)", "United States (603)", "Vanuatu (5)", "Venezuela (1)", "Vietnam (9)", "Zambia (2)", "Zimbabwe (2)" ] } }, "locations": { "title": "Cities, states, or postcodes", "type": "array", "description": "Only firms with an office in these places, e.g. \"Texas\", \"Austin\", \"London\", \"NSW\", \"2000\".", "items": { "type": "string" } }, "nearCity": { "title": "Near a city", "type": "string", "description": "Only firms with an office around this city, e.g. \"Sydney\" or \"Austin, US\". Pick the distance below." }, "radiusKm": { "title": "Distance from the city", "enum": [ "5", "10", "25", "50", "100" ], "type": "string", "description": "How far from \"Near a city\" an office can be." }, "tiers": { "title": "Xero partner tier", "type": "array", "description": "Platinum and Gold firms are the biggest Xero partners. Leave empty for all.", "items": { "type": "string", "enum": [ "PLATINUM", "GOLD", "SILVER", "BRONZE", "STARTER", "PLATINUMGROUP", "NONE" ], "enumTitles": [ "Platinum", "Gold", "Silver", "Bronze", "Blue", "Platinum group", "No tier" ] } }, "industries": { "title": "Clients they serve", "type": "array", "description": "Firms that work with clients in any of these industries.", "items": { "type": "string", "enum": [ "Accommodation and hospitality", "Administration and support services", "Advertising and consulting", "Agriculture", "Arts and recreation", "Construction and trades", "E-commerce", "Education", "Finance and insurance", "Healthcare and social services", "Manufacturing", "Marketing", "Media and communications", "Mining", "Not-for-profit", "Professional services", "Public administration", "Real estate and hiring services", "Repairs and personal services", "Retail", "Transportation and storage", "Utilities", "Wholesale" ], "enumTitles": [ "Accommodation and hospitality", "Administration and support services", "Advertising and consulting", "Agriculture", "Arts and recreation", "Construction and trades", "E-commerce", "Education", "Finance and insurance", "Healthcare and social services", "Manufacturing", "Marketing", "Media and communications", "Mining", "Not-for-profit", "Professional services", "Public administration", "Real estate and hiring services", "Repairs and personal services", "Retail", "Transportation and storage", "Utilities", "Wholesale" ] } }, "specialties": { "title": "Badges they must have", "type": "array", "description": "Xero badges the firm must hold, e.g. payroll specialist or tax expert. All the ones you pick are required.", "items": { "type": "string", "enum": [ "L1 certified associate", "L2 certified professional", "Payroll specialist", "Migration specialist", "L3 Certified Specialist", "Tax expert", "Inventory Plus expert" ], "enumTitles": [ "L1 certified associate", "L2 certified professional", "Payroll specialist", "Migration specialist", "L3 Certified Specialist", "Tax expert", "Inventory Plus expert" ] } }, "professionalBodies": { "title": "Professional bodies", "type": "array", "description": "Firms that are members of any of these, e.g. AICPA, ICAEW, CPA Australia.", "items": { "type": "string", "enum": [ "Chartered Accountants of Australia & New Zealand", "CPA Australia", "Association of Chartered Certified Accountants", "Institute of Chartered Accountants in England and Wales", "Association of Accounting Technicians (UK)", "National Tax & Accountants Association", "Institute of Public Accountants", "Institute of Certified Bookkeepers (AU)", "The Tax Institute", "Australian Bookkeepers Association", "Chartered Institute of Management Accountants", "Chartered Institute of Taxation", "Association of Taxation Technicians", "Institute of Certified Bookkeepers (UK)", "American Institute of CPAs", "Self Managed Super Fund Association", "Accountants + Tax Agents Institute of NZ", "Financial Planning Association", "Institute of Chartered Accountants of Scotland", "Association of Accounting Technicians (AU)", "NZ Bookkeepers Association Incorporated", "International Association of Bookkeepers", "CPA Canada", "Institute of Financial Accounting", "Bookkeeping Institute of Australia", "Chartered Global Management Accountants", "National Association of Tax Professionals", "Chartered Accountants Ireland", "Institute of Certified Bookkeepers (NZ)", "Institute of Singapore Chartered Accountants", "National Association of Enrolled Agents", "Certified Public Accountants Association", "American Institute of Professional Bookkeepers", "NZ Payroll Practitioners Association", "Association of Financial Advisers", "Bstar Alliance Partner", "Chartered Accountants ANZ", "Association of Taxation & Management Accountants", "Accountex Network", "Malaysian Institute of Accountants", "The Institute of Internal Auditors", "Financial Services Institute of Australasia", "The Chartered Institute of Payroll Professionals", "Institute of Management Accountants", "Association of Certified Fraud Examiners", "California Society of CPAs", "Institute of Professional Bookkeepers of Canada", "The Hong Kong Institute of Certified Public Accountants", "Profit First Professionals", "Philippine Institute of Certified Public Accountants", "NZ CA An Association of Independent Chartered Accountants", "National Bookkeepers Association", "NZ Institute of Management", "Association of International Accountants (AIA)", "Smithink", "The Accountants' RePublic", "National Association of Certified Public Bookkeepers", "Florida Institute of CPAs", "Information Systems Audit and Control Association", "Hong Kong Institute of Chartered Secretaries", "The Professional Association of Small Business Accountants", "The Taxation Institute of Hong Kong", "CIMA Malaysia", "AGN International", "CIMA Singapore", "The Malaysian Institute of Certified Public Accountants", "Boomer Technology Circles", "Chartered Institute for IT Professionals", "ICAEW Malaysia", "The Society of Chinese Accountants and Auditors", "Leading Edge Alliance", "Results Group", "American Accounting Association", "Xero Partner Advisory Board", "IT Accountants Association", "Indonesian Institute of Certified Public Accountants", "Association of Women Accountants (Hong Kong) Ltd", "Hong Kong Institute of Accredited Accounting Technicians", "Bank Administration Institute" ], "enumTitles": [ "Chartered Accountants of Australia & New Zealand (2866)", "CPA Australia (2185)", "Association of Chartered Certified Accountants (1958)", "Institute of Chartered Accountants in England and Wales (1574)", "Association of Accounting Technicians (UK) (1547)", "National Tax & Accountants Association (1188)", "Institute of Public Accountants (1104)", "Institute of Certified Bookkeepers (AU) (1089)", "The Tax Institute (912)", "Australian Bookkeepers Association (767)", "Chartered Institute of Management Accountants (486)", "Chartered Institute of Taxation (463)", "Association of Taxation Technicians (425)", "Institute of Certified Bookkeepers (UK) (390)", "American Institute of CPAs (235)", "Self Managed Super Fund Association (197)", "Accountants + Tax Agents Institute of NZ (189)", "Financial Planning Association (167)", "Institute of Chartered Accountants of Scotland (156)", "Association of Accounting Technicians (AU) (150)", "NZ Bookkeepers Association Incorporated (135)", "International Association of Bookkeepers (124)", "CPA Canada (123)", "Institute of Financial Accounting (97)", "Bookkeeping Institute of Australia (88)", "Chartered Global Management Accountants (83)", "National Association of Tax Professionals (78)", "Chartered Accountants Ireland (71)", "Institute of Certified Bookkeepers (NZ) (69)", "Institute of Singapore Chartered Accountants (63)", "National Association of Enrolled Agents (56)", "Certified Public Accountants Association (53)", "American Institute of Professional Bookkeepers (49)", "NZ Payroll Practitioners Association (47)", "Association of Financial Advisers (47)", "Bstar Alliance Partner (47)", "Chartered Accountants ANZ (46)", "Association of Taxation & Management Accountants (41)", "Accountex Network (37)", "Malaysian Institute of Accountants (34)", "The Institute of Internal Auditors (31)", "Financial Services Institute of Australasia (31)", "The Chartered Institute of Payroll Professionals (30)", "Institute of Management Accountants (29)", "Association of Certified Fraud Examiners (28)", "California Society of CPAs (27)", "Institute of Professional Bookkeepers of Canada (27)", "The Hong Kong Institute of Certified Public Accountants (22)", "Profit First Professionals (22)", "Philippine Institute of Certified Public Accountants (20)", "NZ CA An Association of Independent Chartered Accountants (20)", "National Bookkeepers Association (18)", "NZ Institute of Management (17)", "Association of International Accountants (AIA) (15)", "Smithink (15)", "The Accountants' RePublic (15)", "National Association of Certified Public Bookkeepers (13)", "Florida Institute of CPAs (12)", "Information Systems Audit and Control Association (11)", "Hong Kong Institute of Chartered Secretaries (9)", "The Professional Association of Small Business Accountants (9)", "The Taxation Institute of Hong Kong (8)", "CIMA Malaysia (8)", "AGN International (7)", "CIMA Singapore (6)", "The Malaysian Institute of Certified Public Accountants (6)", "Boomer Technology Circles (5)", "Chartered Institute for IT Professionals (5)", "ICAEW Malaysia (4)", "The Society of Chinese Accountants and Auditors (4)", "Leading Edge Alliance (4)", "Results Group (3)", "American Accounting Association (3)", "Xero Partner Advisory Board (3)", "IT Accountants Association (2)", "Indonesian Institute of Certified Public Accountants (1)", "Association of Women Accountants (Hong Kong) Ltd (1)", "Hong Kong Institute of Accredited Accounting Technicians (1)", "Bank Administration Institute (1)" ] } }, "keywords": { "title": "Keywords", "type": "array", "description": "Words in the firm's name or description, e.g. \"ecommerce\", \"CFO\", \"SMSF\". Any of them matches.", "items": { "type": "string" } }, "partnerSinceFrom": { "title": "Xero partner since (from year)", "minimum": 0, "type": "integer", "description": "Only firms that joined Xero in or after this year, e.g. 2024 for new partners." }, "partnerSinceTo": { "title": "Xero partner since (to year)", "minimum": 0, "type": "integer", "description": "Only firms that joined Xero in or before this year, e.g. 2014 for long-time partners." }, "minOffices": { "title": "At least this many offices", "minimum": 0, "type": "integer", "description": "For bigger practices, e.g. 3." }, "minStaff": { "title": "At least this many team members", "minimum": 0, "type": "integer", "description": "Counts the team members the firm lists on Xero." }, "findEmails": { "title": "Find emails", "type": "boolean", "description": "Looks for the firm's email on its own website. Slower, and a firm with an email found costs a little extra. Adds the email, its type (like info@ or a person), and whether it can receive mail.", "default": false }, "mustHave": { "title": "Only firms with", "type": "array", "description": "Skip firms missing these, e.g. phone and website for cold calling.", "items": { "type": "string", "enum": [ "phone", "website", "linkedin", "email", "staff" ], "enumTitles": [ "Phone number", "Website", "LinkedIn page", "Email address (needs email finding)", "Named team members" ] } }, "includeStaff": { "title": "Add team members", "type": "boolean", "description": "Adds each team member's name, job title, and short bio.", "default": false }, "outputMode": { "title": "One row per", "enum": [ "firm", "office" ], "type": "string", "description": "A firm with 3 offices gives 3 rows in office mode, and is still charged once.", "default": "firm" }, "alertMode": { "title": "What to return", "enum": [ "all", "new", "changes" ], "type": "string", "description": "For scheduled runs: the first run returns everything, later runs only what is new or changed.", "default": "all" } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }