TrustATrader Scraper

Extract UK trade professionals from TrustATrader — the UK's leading vetted trades directory. Search by keyword and location, browse by trade category, or scrape individual trader profile pages.

Features

• Search mode — find traders by keyword (e.g. "plumber", "electrician") and location
• By Trade mode — browse any of 20 trade categories filtered by UK town or city
• Trader Profile mode — fetch detailed profiles by URL including phone number, description, and rating
• By URL mode — scrape any TrustATrader category or profile URL directly
• Pagination — automatically pages through all results up to maxItems
• Optional profile enrichment — fetch each trader's full profile page for phone number, logo, and extended description

Input

Field	Type	Description
mode	select	What to scrape: search, byTrade, traderProfile, or byUrl
searchQuery	string	Trade keyword for search mode (e.g. plumber, electrician)
location	string	UK city or town (e.g. London, Manchester, Bristol)
trade	select	Trade category for byTrade mode (20 options: plumbers, electricians, builders, etc.)
startUrls	list	TrustATrader URLs for traderProfile or byUrl mode
maxItems	integer	Maximum records to emit (1–500, default 20)
fetchProfiles	boolean	Fetch each trader's profile page for full data (default false)

Example Inputs

Search by keyword and location:

{
  "mode": "search",
  "searchQuery": "plumber",
  "location": "London",
  "maxItems": 50
}

Browse by trade category:

{
  "mode": "byTrade",
  "trade": "electricians",
  "location": "Manchester",
  "maxItems": 100
}

Fetch specific trader profiles:

{
  "mode": "traderProfile",
  "startUrls": [
    "https://www.trustatrader.com/traders/some-trader-london"
  ]
}

With full profile enrichment:

{
  "mode": "search",
  "searchQuery": "builder",
  "location": "Birmingham",
  "maxItems": 30,
  "fetchProfiles": true
}

Output

Each record represents one UK trade professional:

{
  "name": "J Smith Plumbing",
  "trade": "Plumbers",
  "rating": 9.8,
  "reviewCount": 142,
  "location": "London",
  "city": "London",
  "phone": "020 1234 5678",
  "description": "Fully qualified plumber covering all of Central London...",
  "logoUrl": "https://www.trustatrader.com/...",
  "verified": true,
  "url": "https://www.trustatrader.com/traders/j-smith-plumbing",
  "slug": "j-smith-plumbing",
  "scrapedAt": "2025-01-15T10:30:00+00:00"
}

Field	Type	Description
name	string	Trader or business name
trade	string	Trade category (when available from profile page)
rating	number	TrustATrader rating score (0–10)
reviewCount	integer	Number of verified reviews
location	string	Town or city
city	string	Same as location
phone	string	Phone number (requires fetchProfiles: true or profile mode)
description	string	Business description
logoUrl	string	Trader logo image URL
verified	boolean	Whether trader is vetted/approved
url	string	TrustATrader profile URL
slug	string	URL slug identifier
scrapedAt	string	ISO-8601 timestamp of when the record was scraped

Fields are omit-empty — only fields with real values are included in each record.

Trade Categories

The following 20 trade categories are supported for byTrade mode:

plumbers, electricians, builders, decorators, roofers, plasterers, gas-engineers, landscapers, carpet-fitters, tilers, joiners, carpenters, driveway-contractors, kitchen-fitters, bathroom-fitters, double-glazing, locksmiths, painters, loft-conversions, extensions

Performance

• Search and category pages: ~20–50 traders per page
• With fetchProfiles: false (default): fast, ~100 traders/minute
• With fetchProfiles: true: full data including phone, ~30 traders/minute
• Respects site rate limits with automatic retries on 429/503

FAQs

Does this require API keys or login? No. TrustATrader is publicly accessible. No authentication, cookies, or proxy required.

What UK locations are supported? Any UK town, city, or area that TrustATrader indexes — London, Manchester, Birmingham, Leeds, Bristol, Edinburgh, Glasgow, Cardiff, and hundreds more.

Why does phone only appear sometimes? Phone numbers are only on individual trader profile pages. Enable fetchProfiles: true or use mode: traderProfile to retrieve them.

What is the verified field? TrustATrader vets all its traders — the verified: true flag indicates the trader has passed their checks.

What is byUrl mode for? Paste any TrustATrader category URL (e.g. /plumbers-in-london) or profile URL directly if you want to scrape a specific page not covered by other modes.

How does pagination work? The scraper automatically follows ?page=N pagination until maxItems is reached or no more results are found.