# MyBuilder Scraper — UK Tradespeople Leads by Trade & City (`scrapersdelight/mybuilder-scraper`) Actor

Turn any MyBuilder trade + city into a ranked UK tradespeople lead list: business name, star rating, review count, verified & featured badges, bio, services and sample reviews. One row per tradesperson from the site's public directory. No login.

- **URL**: https://apify.com/scrapersdelight/mybuilder-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** Lead generation, Automation, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$4.00 / 1,000 per tradesperson returneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## MyBuilder Scraper — UK Tradespeople Leads by Trade & City

Turn any [MyBuilder](https://www.mybuilder.com) trade + city into a clean, ranked
list of UK tradespeople. One row per tradesperson, straight from MyBuilder's
public directory pages and each profile's `LocalBusiness` schema — no login.

### What you get (one row per tradesperson)

**From the listing card (always):**
`serviceProId`, `businessName`, `tradeCategory`, `locationSlug`,
`tradeLocationSummary`, `avgReviewScore`, `reviewCount`, `isVerified`,
`isFeaturedAd`, `badges`, `positionInList`, `pageNumber`, `bio`,
`latestReviewSnippet`, `totalResultsForQuery`, `profileUrl`.

**From the profile page (when "Fetch full profile details" is on):**
`legalName`, `leiCode`, `description` (full "About" text), `addressLocality`,
`addressCountry`, `services` (what they offer), `profileRatingValue`,
`profileReviewCount`, `sampleReviews` (author, date, rating, text).

### How to use

Give it one or more MyBuilder listing URLs:

- By trade + city: `https://www.mybuilder.com/electrical/electrician-tradespeople/london`
- All trades in a city: `https://www.mybuilder.com/find-trades/manchester`

Set **Max tradespeople** and it paginates automatically (~16 per page). Turn off
**Fetch full profile details** for a faster, listing-only run.

### Important: this is a lead-scoring tool, not contact enrichment

MyBuilder is a lead-generation marketplace. It does **not** publish phone, email
or website for tradespeople — customer contact happens through MyBuilder's own
"post a job" form by design. This actor gives you everything MyBuilder makes
public (who to shortlist: ratings, review volume, verified/featured status,
services, bio, sample reviews), **not** direct contact details.

### Proxy

MyBuilder is Cloudflare-fronted and UK-geofenced. The actor defaults to Apify
**Residential** proxy, **country GB** — this is required; datacenter proxy is
blocked. A fresh proxy session is used per request with automatic retry on a
Cloudflare challenge.

### Legal / terms

You are responsible for complying with MyBuilder's Terms of Service. Some fields
(business names, review-author names, review text) are personal data — handling
it (including under UK/EU GDPR) is your responsibility. Scrape only what you are
entitled to and use it lawfully.

# Actor input Schema

## `startUrls` (type: `array`):

MyBuilder directory listing pages by trade + city, e.g. https://www.mybuilder.com/electrical/electrician-tradespeople/london or an all-trades city page https://www.mybuilder.com/find-trades/manchester . The scraper paginates each one automatically.

## `maxItems` (type: `integer`):

Stop after this many tradespeople across all listing URLs (0 = no limit; a full city trade can be thousands).

## `maxPagesPerUrl` (type: `integer`):

Safety cap on how many result pages to walk per listing URL (~16 tradespeople per page). 0 = walk until the listing ends.

## `includeProfileDetails` (type: `boolean`):

For each tradesperson, also fetch their profile page to add the full description, precise locality, services offered and sample reviews (from the LocalBusiness schema). This doubles the number of requests against a Cloudflare-protected site, so runs are slower and some profiles may be skipped (the listing-level fields are always returned). Off by default.

## `proxyConfiguration` (type: `object`):

Proxy settings. MyBuilder is Cloudflare-fronted and UK-geofenced, so Apify Proxy RESIDENTIAL (country GB) is the reliable default. Datacenter proxy is blocked and will not work.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.mybuilder.com/electrical/electrician-tradespeople/london"
    }
  ],
  "maxItems": 100,
  "maxPagesPerUrl": 0,
  "includeProfileDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "GB"
  }
}
```

# Actor output Schema

## `records` (type: `string`):

The dataset of scraped MyBuilder tradespeople (one item per tradesperson/lead).

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.mybuilder.com/electrical/electrician-tradespeople/london"
        }
    ],
    "maxItems": 100,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "GB"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/mybuilder-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://www.mybuilder.com/electrical/electrician-tradespeople/london" }],
    "maxItems": 100,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "GB",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/mybuilder-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.mybuilder.com/electrical/electrician-tradespeople/london"
    }
  ],
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "GB"
  }
}' |
apify call scrapersdelight/mybuilder-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapersdelight/mybuilder-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ROs7m2s3JRLWxfr4B/builds/oz5QxK8GsjIsgQU9A/openapi.json