# Checkatrade Scraper & API - UK Tradesperson Data (`parsebird/checkatrade-scraper`) Actor Scrape verified UK tradesperson listings from Checkatrade. Extract ratings, phone numbers, VAT status, service areas, badges, and full profile details by location and trade category. - **URL**: https://apify.com/parsebird/checkatrade-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Categories:** Jobs, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.39 / 1,000 profile scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ### Checkatrade Scraper & API - UK Tradesperson Data Scrape verified UK tradesperson listings from [Checkatrade](https://www.checkatrade.com/), the UK's largest vetted tradesperson directory. Search any location and trade category to extract ratings, phone numbers, VAT status, service areas, trust badges, and full profile details — no login or API key required.
Search by UK location and any of 1,500+ trade categories, then enrich every result with company details, VAT registration, Checkatrade tenure, trust badges, and verified contact info.
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ``` parsebird/checkatrade-scraper on Apify. Call: ApifyClient("TOKEN").actor("parsebird/checkatrade-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: location (string, required, e.g. "London", "Manchester", "GL5", "SW1A 1AA" — city, postcode, or postcode area), category (string, required, trade slug e.g. "Plumber", "Electrician", "Roofer" — 1,500+ supported), max_pages (integer, default 0 = no limit), require_phone_number (boolean, default false, filters out listings with no phone number). Output fields: name, rating, review_count, phone_number, area_served, currencies_accepted, description, website, trade_url, logo_url, location, trade_details (owner/company status/VAT), labels (trust badges), category. Full actor spec: fetch build via GET https://api.apify.com/v2/acts/parsebird~checkatrade-scraper (Bearer TOKEN). Get token: https://console.apify.com/account/integrations ``` ### What does Checkatrade Scraper do? This Actor scrapes [checkatrade.com](https://www.checkatrade.com/), searching by UK **location** (city, town, or postcode) and **trade category** (Plumber, Electrician, Roofer, Builder, and 1,500+ others). It collects the full results list, then visits each tradesperson's profile page to pull verified company details. - 📍 **Any UK location** — search by city, town, or full/partial postcode - 🔧 **1,500+ trade categories** — from Plumbers and Electricians to niche trades like Zinc Roof Installers - ✅ **Verified company data** — VAT registration, Sole Trader/Ltd Company status, years on Checkatrade - 🏅 **Trust badges** — Domestic Work, Free Estimates, Insurance Work Undertaken, and more - 📞 **Direct contact info** — phone numbers and company websites, with an optional phone-only filter - ⏱️ **Scheduling** — run this Actor daily, weekly, or on any interval via Apify Scheduler to track new tradespeople or rating changes - 🔌 **API access** — trigger runs and pull results programmatically via the Apify API or client libraries - 🔗 **Integrations** — connect to Google Sheets, Zapier, Make, Slack, and webhooks without writing code - 📊 **Flexible export** — download results as JSON, CSV, or Excel, or query them via API ### What data can you extract from Checkatrade? | Field | Description | |-------|-------------| | `name` | Tradesperson or company name | | `rating` | Checkatrade rating out of 10 | | `review_count` | Number of customer reviews | | `phone_number` | Direct contact phone number | | `area_served` | Towns/regions the company covers | | `description` | Company bio / "About us" text | | `website` | Company website URL, if listed | | `trade_url` | Full Checkatrade profile URL | | `logo_url` | Company logo image URL | | `location` | Primary town/city | | `trade_details` | Owner name, Sole Trader/Ltd Company status + tenure, VAT registration | | `labels` | Trust badges (Domestic Work, Free Estimates, Insurance Work Undertaken, etc.) | | `category` | Trade category searched | ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `location` | string | **Yes** | — | UK city, town, or postcode, e.g. `London`, `Manchester`, `GL5`, `SW1A 1AA` | | `category` | string | **Yes** | `Plumber` | Trade category slug — 1,500+ supported, e.g. `Plumber`, `Electrician`, `Roofer`, `Builder` | | `max_pages` | integer | No | `0` | Max search-result pages to fetch. `0` = no limit (pagination stops automatically once no new listings appear) | | `require_phone_number` | boolean | No | `false` | When `true`, only returns listings that have a phone number | ### Output example ```json { "name": "Kerry Maintenance Ltd", "rating": "9.28", "review_count": 381, "phone_number": "07307203813", "area_served": "Stroud, Gloucestershire", "currencies_accepted": "GBP", "description": "At Kerry Maintenance Ltd we can maintain your whole property. From your boiler, pipes, and central heating, through to your bathroom, kitchen and garden. Our family run business with over 50 years' combined experience, provides property maintenance throughout Stroud, Gloucestershire and South Gloucestershire.\nOur fully manned office is open 9am-4pm Monday - Friday to help with any plumbing, heating and property problems you have.\nTake advantage of our competitive rates in Gas Appliance Services.", "website": "http://www.kerrymaintenance.com/", "trade_url": "https://www.checkatrade.com/trades/kerrymaintenance", "logo_url": "https://lh3.googleusercontent.com/dEBbz4DUSKLH9X7x1Y1pjISjcd2DwiFagR0oC9E9K6H0IBed5op7W69ZHRBycRG8IbeWkdeqFQL6wmGlfbMs5A_PzLLhKEYqxYqJmru4E4d-yuwadCj_PHHX-4FHTdA", "location": "Stroud", "trade_details": { "Owner": "Mr Matthew Kerry", "Ltd Company": "9 years on Checkatrade", "VAT Registered": "Yes: 841124463" }, "labels": ["Domestic Work", "Free Estimates", "Cards Accepted", "Insurance Work Undertaken", "Commercial Work"], "category": "Plumber" } ``` Download results in **JSON, CSV, HTML, or Excel** directly from the Apify Console, or pull them programmatically via the API. ### Use cases - **Lead generation** — build targeted contact lists of tradespeople by trade and UK region for B2B outreach - **Market research** — analyze trade density, ratings, and tenure across cities to spot underserved areas - **Competitor monitoring** — track a competitor's rating, review count, and badges over time with a scheduled run - **Directory building** — feed verified tradesperson data into your own local-services marketplace or aggregator - **Due diligence** — check VAT registration and Sole Trader/Ltd Company status before engaging a contractor - **Recruitment** — identify established, highly-rated tradespeople in a specific category and region ### How it works 1. Go to the [Checkatrade Scraper](https://apify.com/parsebird/checkatrade-scraper) page on Apify Store 2. Click **Try for free** — new users get a free trial to test the Actor before paying 3. Enter a **location** (e.g. `London`, `Bristol`, `GL5`) and a **category** (e.g. `Plumber`, `Electrician`, `Roofer`) 4. Optionally set `max_pages` to cap the search, or enable `require_phone_number` to skip listings with no phone number 5. Click **Start** — the Actor fetches search-result pages, then visits every profile page to pull rating, VAT status, tenure, and trust badges 6. When the run finishes, download your data as **JSON, CSV, or Excel**, or fetch it via the API ### Use with the Apify API **Python** ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("parsebird/checkatrade-scraper").call(run_input={ "location": "London", "category": "Electrician", "max_pages": 3, "require_phone_number": True, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"{item['name']} - {item['rating']} ({item['review_count']} reviews) - {item['phone_number']}") ``` **JavaScript** ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor('parsebird/checkatrade-scraper').call({ location: 'London', category: 'Electrician', max_pages: 3, require_phone_number: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.log(`${item.name} - ${item.rating} (${item.review_count} reviews) - ${item.phone_number}`); }); ``` See the [Apify API documentation](https://docs.apify.com/api/v2) for full reference, or the Actor's **API** tab for ready-to-run request snippets in more languages. ### How much does it cost to scrape Checkatrade with this Actor? This Actor uses **Pay-per-event** pricing — you only pay for tradesperson profiles actually scraped, with no separate platform rental fee. | Plan | Price per event | Price per 1,000 | |------|-----------------|-----------------| | Free | $0.00349 | $3.49 | | Bronze | $0.00299 | $2.99 | | Silver | $0.00269 | $2.69 | | Gold | $0.00239 | $2.39 | One `trade-scraped` event is charged for each tradesperson profile successfully scraped and pushed to the dataset. For example, scraping 500 profiles on the Free plan costs about $1.75; the same run on a Gold subscription costs about $1.20. Start with the free trial to test the Actor on a small `max_pages` value before scaling up. ### FAQ **Is it legal to scrape Checkatrade?** Checkatrade lists publicly accessible tradesperson profiles. Scraping publicly available data is generally permitted, but you're responsible for complying with Checkatrade's Terms of Service and applicable data protection laws (including UK GDPR) in your jurisdiction, especially if you store or process personal data like phone numbers. See Apify's [blog post on the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) for more detail. **What locations does this Actor support?** Any UK location Checkatrade supports: city or town names (`London`, `Manchester`), full postcodes (`SW1A 1AA`), or postcode areas (`GL5`). **How many trade categories are supported?** Over 1,500, matching Checkatrade's own category list — from common trades like Plumber and Electrician to niche categories like Zinc Roof Installers. **Can I filter for tradespeople with a phone number?** Yes — set `require_phone_number` to `true` to drop any listing without one. **Does pagination stop automatically?** Yes. Leave `max_pages` at `0` and the Actor keeps fetching pages until Checkatrade stops returning new listings, so you never need to guess how many pages a category has. **Can I schedule recurring runs?** Yes. Use Apify's [Scheduler](https://docs.apify.com/platform/schedules) to run this Actor daily, weekly, or at any interval and track changes in ratings, tenure, or new listings over time. **Can I access results via API?** Yes. Every run's dataset is available through the [Apify API](https://docs.apify.com/api/v2) and client libraries (Python, JavaScript) — see the Actor's **API** tab for ready-made snippets. **Something not working?** Open an issue on the Actor's **Issues** tab in Apify Console — the ParseBird team monitors it directly. ### Related Actors Other business and lead-data Actors from ParseBird: - [BuildZoom Scraper](https://apify.com/parsebird/buildzoom-scraper) — contractor and licensing data from the largest US contractor directory - [JustDial Business Scraper](https://apify.com/parsebird/justdial-business-scraper) — verified business listings from India's largest local search directory - [Website Contact Finder](https://apify.com/parsebird/website-contact-finder) — extract emails, phone numbers, and social links from any website # Actor input Schema ## `location` (type: `string`): The UK location to search for trades. Use a city ("London"), a full postcode ("SW1A 1AA"), or a postcode area/district ("GL", "GL1"). ## `category` (type: `string`): Business category or subcategory to filter listings (e.g. "Plumber", "Electrician", "Roofer"). Must be one of Checkatrade's official trade categories. ## `max_pages` (type: `integer`): Maximum number of result pages to scrape. Set to 0 for no limit (scraper stops automatically once no new tradespeople are found on a page). ## `require_phone_number` (type: `boolean`): When enabled, only return tradespeople that have a phone number listed on their profile. ## Actor input object example ```json { "location": "GL1", "category": "Plumber", "max_pages": 0, "require_phone_number": false } ``` # Actor output Schema ## `dataset` (type: `string`): No description # 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 = { "location": "GL1", "category": "Plumber", "max_pages": 0, "require_phone_number": false }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/checkatrade-scraper").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 = { "location": "GL1", "category": "Plumber", "max_pages": 0, "require_phone_number": False, } # Run the Actor and wait for it to finish run = client.actor("parsebird/checkatrade-scraper").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 '{ "location": "GL1", "category": "Plumber", "max_pages": 0, "require_phone_number": false }' | apify call parsebird/checkatrade-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parsebird/checkatrade-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/XbZRnC5nGyaK7Rzeb/builds/fAk30S3VtTXoUGLWG/openapi.json