# Thumbtack Email Scraper (`leads-scraper/thumbtack-email-scraper`) Actor

Thumbtack Email Scraper SD - Thumbtack Email Scraper is a lead generation tool that extracts leads with public contact emails, account names and profile URLs from Thumbtack results by keyword, location and email domain - Thumbtack email extractor.

- **URL**: https://apify.com/leads-scraper/thumbtack-email-scraper.md
- **Developed by:** [Leads Scraper](https://apify.com/leads-scraper) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### Thumbtack Email Scraper

The Thumbtack Email Scraper extracts publicly indexed service-pro contacts from Thumbtack using Google search.
Thumbtack is the US marketplace where homeowners hire handymen, cleaners, movers, electricians and hundreds of other trades.
This Actor turns keywords, an optional location and a list of email domains into a clean dataset of pro leads.

You get the business name, the Thumbtack handle, the pro profile URL and a listing snippet alongside each address.
Identity resolution on this platform is excellent, which makes the output easy to verify by hand.
The email harvest is thinner, and the yield section below is honest about exactly how thin.

The Thumbtack Email Scraper does not log in, does not use a Thumbtack API and never opens thumbtack.com.
Every record comes from publicly available Google search results: titles, snippets and site labels.
There is no browser, no JavaScript rendering, no authentication and no cookies.

In a measured live run, the Thumbtack Email Scraper returned 10 result blocks, 10 identity matches, 10 profile URLs and 4 unique emails.
Every single block resolved to a named pro with a working profile URL, which is the best identity result in this category.
Four of those ten carried a usable address, so plan for a high-quality but moderate-volume list.

#### Who the Thumbtack Email Scraper is for

Thumbtack pros are independent tradespeople and small crews: handymen, painters, movers, cleaners, tutors and event services.
The natural audience is everyone who sells to them, from tool and materials suppliers to insurance brokers and trade-credit providers.
Lead-generation software vendors and franchise recruiters use the same list from the other side.

The default modifiers are `email`, `contact`, `enquiries`, `owner` and `get a quote`.
Those mirror the words a service pro uses when inviting a homeowner to make contact.
Change them and you change which slice of the marketplace you reach.

### Key features of the Thumbtack Email Scraper

Everything below is behaviour the Thumbtack Email Scraper actually implements, shared with every Actor in this family.

| Feature | What it does |
|---|---|
| Google `site:` targeting | Restricts every query to `thumbtack.com`, so results stay on pro listings |
| Query expansion | Base, quoted and `intitle:` variants plus one variant per query modifier |
| Trade-intent modifiers | Defaults of `email`, `contact`, `enquiries`, `owner` and `get a quote` |
| Domain filtering | Keeps only emails ending in the domains you list |
| Global deduplication | One row per unique email across every query and every page |
| Email normalisation | Understands `name [at] domain [dot] com`, `name (at) domain`, `name @ domain.com`, `domain .com`, zero-width characters and the full-width `＠` sign |
| Junk filter | Rejects `email@`, `yourname@`, `test@`, `xxx@` and single-character locals |
| Boundary-correct matching | `@gmail.com` does not match inside `@gmail.company` or `@gmail.com.br` |
| Soft-wrap repair | Drops a hit that is only the tail of another email in the same block |
| Structural block parsing | Locates the `<h3>` title and the smallest surrounding block instead of relying on CSS class names |
| Whole-page fallback parser | A Google markup change degrades to emails without account details, not to zero results |
| Concurrency | `asyncio` worker pool with a shared stop signal once `maxEmails` is reached |
| Retries and block detection | Three attempts per page with exponential backoff; CAPTCHA and consent pages are retried, not counted as empty |
| Re-queue pass | Blocked or failed queries are retried once at the end of the run |
| Resumable state | Key-value store state keyed by an input hash, saved on `PERSIST_STATE`, `MIGRATING` and `ABORTING` |
| Immediate dataset writes | Each lead is pushed as soon as it is found |
| Run summary | Logs pages fetched, blocked pages, retries and emails per page |

### How the Thumbtack Email Scraper works

The Thumbtack Email Scraper reads your input, builds Google queries, fetches result pages and parses each block structurally.
Emails are extracted from block text with a domain-filtered regex, normalised, junk-filtered and deduplicated globally.
Each surviving lead is pushed to the Apify dataset immediately, so a partial run is still usable.

A query looks like `site:thumbtack.com handyman "@gmail.com" "Denver"`.
Pages are fetched through the Apify GOOGLE_SERP proxy over async HTTP with a fresh proxy session per request.
Structural parsing means a Google layout change degrades the run rather than breaking it.

#### Query expansion in the Thumbtack Email Scraper

Google caps a single query at roughly 300 results, and Thumbtack lists pros in hundreds of categories across every US metro.
Query expansion multiplies each keyword by each email domain and by several phrasings, with base queries running first.
Given the moderate email density here, expansion is what turns a handful of rows into a usable list.

#### Location is the strongest lever in the Thumbtack Email Scraper

`location` matters more on Thumbtack than almost anywhere else in this category.
Pros are matched to homeowners by service area, so every listing is written with a city or metro in it.
Run the same keyword set once per metro and merge the datasets afterwards rather than attempting one national sweep.

#### Choosing trade keywords for the Thumbtack Email Scraper

Thumbtack category names are the highest-yield keywords because they match the platform's own taxonomy.
`house cleaning`, `local moving`, `furniture assembly`, `interior painting` and `handyman` all map to real categories.
Six to ten category keywords per metro is a sensible working range.

### Input reference for the Thumbtack Email Scraper

The Thumbtack Email Scraper takes nine inputs and only `keywords` is required.

| Field | Type | Default | Meaning |
|---|---|---|---|
| `keywords` | array (required) | `["contractor", "handyman"]` | Search terms describing the pros you want |
| `location` | string | `""` | Optional location phrase added to every query |
| `customDomains` | array | `["@gmail.com", "@yahoo.com"]` | Only emails on these domains are kept; `@` optional |
| `maxEmails` | integer 1-10000 | `20` | Stop after this many unique emails |
| `countryCode` | string | `""` | Two-letter country code for the search proxy (US, GB, DE) |
| `expandQueries` | boolean | `true` | Search each keyword x domain pair in several phrasings |
| `queryModifiers` | array | `["email", "contact", "enquiries", "owner", "get a quote"]` | Extra words combined with each keyword when expansion is on |
| `maxPagesPerQuery` | integer 1-50 | `30` | Page cap per query |
| `maxConcurrency` | integer 1-20 | `5` | Parallel queries |

#### Example input

```json
{
  "keywords": ["handyman", "house cleaning", "local moving", "interior painting"],
  "location": "Denver",
  "customDomains": ["@gmail.com", "@yahoo.com", "@outlook.com", "@aol.com"],
  "maxEmails": 300,
  "countryCode": "US",
  "expandQueries": true,
  "queryModifiers": ["email", "contact", "enquiries", "owner", "get a quote"],
  "maxPagesPerQuery": 30,
  "maxConcurrency": 5
}
```

#### Tuning the Thumbtack Email Scraper

Because email density is moderate, widen rather than narrow.
Keep four free-mail domains in `customDomains` and raise `maxEmails` well above the default of 20.
Then narrow with `location` instead, one metro at a time.

Independent trades overwhelmingly use free-mail addresses.
`@gmail.com`, `@yahoo.com`, `@outlook.com` and `@aol.com` cover most of the US market.
Adding a domain multiplies the query count, so expect longer runs when you do.

### Output reference for the Thumbtack Email Scraper

Every dataset item produced by the Thumbtack Email Scraper carries all fourteen fields below.

| Field | Meaning |
|---|---|
| `network` | Platform name |
| `keyword` | The keyword that produced the lead |
| `query` | The exact Google query used |
| `title` | Raw result title |
| `accountName` | Account label Google prints |
| `fullName` | Display name parsed from a profile-style title; empty for non-profile results |
| `username` | URL-safe handle when the platform exposes one; otherwise `null` |
| `profileUrl` | Canonical account URL when a handle is known; otherwise empty |
| `url` | Direct platform link when exposed, else the profile URL |
| `description` | Listing snippet, cleaned of labels and counters |
| `email` | Lower-cased email address |
| `emailDomain` | The matched domain |
| `possiblyTruncated` | `true` when Google's snippet ellipsis touched the email |
| `foundAt` | ISO 8601 UTC timestamp |

#### Example output

```json
[
  {
    "network": "Thumbtack",
    "keyword": "handyman",
    "query": "site:thumbtack.com handyman \"@gmail.com\" \"Denver\"",
    "title": "Front Range Handyman Services - Denver, CO | Thumbtack",
    "accountName": "Front Range Handyman Services",
    "fullName": "Front Range Handyman Services",
    "username": "front-range-handyman-services",
    "profileUrl": "https://www.thumbtack.com/front-range-handyman-services",
    "url": "https://www.thumbtack.com/front-range-handyman-services",
    "description": "Drywall repair, door hanging and general fixes across metro Denver. Get a quote: frontrangehandyman@gmail.com",
    "email": "frontrangehandyman@gmail.com",
    "emailDomain": "@gmail.com",
    "possiblyTruncated": false,
    "foundAt": "2025-11-04T17:06:12Z"
  },
  {
    "network": "Thumbtack",
    "keyword": "local moving",
    "query": "site:thumbtack.com local moving owner \"@yahoo.com\" \"Denver\"",
    "title": "Mile High Movers - Denver, CO | Thumbtack",
    "accountName": "Mile High Movers",
    "fullName": "Mile High Movers",
    "username": "mile-high-movers",
    "profileUrl": "https://www.thumbtack.com/mile-high-movers",
    "url": "https://www.thumbtack.com/mile-high-movers",
    "description": "Two-person crews for apartment and small home moves. Owner enquiries: milehighmovers@yahoo.com",
    "email": "milehighmovers@yahoo.com",
    "emailDomain": "@yahoo.com",
    "possiblyTruncated": true,
    "foundAt": "2025-11-04T17:07:39Z"
  }
]
```

The Apify dataset view shows email, account, name, username, profile, keyword, snippet and the truncation flag.
Export as CSV, JSON or XLSX, or read the dataset through the Apify API.
Because handles resolve reliably here, the profile column is genuinely useful for manual checks.

### Use cases for the Thumbtack Email Scraper

The Thumbtack Email Scraper is aimed at suppliers and service providers selling into the US home-services trades.

| Use case | Suggested keywords | Suggested location |
|---|---|---|
| Selling tools and materials to trades | `handyman`, `interior painting` | one metro per run |
| Contractor insurance and bonding | `general contractor`, `electrical` | state capital or metro |
| Lead-generation software sales | `house cleaning`, `lawn care` | metro area |
| Franchise and territory recruitment | `junk removal`, `pressure washing` | target territory |
| Van, tool and equipment finance | `local moving`, `furniture assembly` | metro area |
| Uniform, branding and print suppliers | `landscaping`, `pest control` | metro area |
| Market research on local service pricing | `handyman`, `house cleaning` | leave empty |

#### Selling into the trades with the Thumbtack Email Scraper

Suppliers benefit most because Thumbtack pros are their end customers.
Use the platform's own category names, one metro per run, and keep the free-mail domains wide.
The `description` field states the trade and service area, which is enough to segment a list quickly.

#### Strong identity resolution in the Thumbtack Email Scraper

Because nearly every block resolves to a handle, the Thumbtack Email Scraper doubles as a pro-directory mapper.
Even rows without an email give you a business name and a linkable profile you can enrich elsewhere.
Filter the dataset for rows where `email` is present when you need only the contactable subset.

### Practical recipes for the Thumbtack Email Scraper

A Denver sweep might use `handyman`, `house cleaning`, `local moving` and `interior painting` with `location` set to `Denver` and `countryCode` to `US`.
A Sun Belt campaign might repeat the same keyword set for `Phoenix`, `Austin`, `Tampa` and `Charlotte` as separate runs.
Keep `expandQueries` on throughout, because one query cannot reach past Google's result cap.

For breadth, drop `location`, keep `maxPagesPerQuery` at 30 and raise `maxEmails`.
For precision, name one metro, use three or four category keywords and set `maxEmails` to a couple of hundred.
Both modes run identical code; only query volume differs.

### How many results the Thumbtack Email Scraper returns

A measured live run of the Thumbtack Email Scraper produced 10 blocks, 10 identity matches, 10 profile URLs and 4 unique emails.
Identity resolution was perfect and email yield was moderate, which is the signature of this platform.
Thumbtack listings are designed to route contact through the marketplace, so many pros never publish an address at all.

Your own numbers will vary with trade, metro, domain list and how much of Thumbtack Google currently indexes.
Free Apify plans stop at 100 emails per run and paid plans are uncapped.
No specific volume is guaranteed by the Thumbtack Email Scraper or by any Actor in this family.

### Limitations of the Thumbtack Email Scraper

- The Thumbtack Email Scraper only finds pros whose email is publicly visible in Google's index. Thumbtack routes most enquiries through its own messaging, so plenty of pros publish no address.
- Google caps a single query at roughly 300 results. Query expansion exists to work around that cap, and disabling it reduces yield sharply.
- `possiblyTruncated: true` means Google's snippet ellipsis touched the email, so the address may be incomplete. Verify those rows before sending.
- `username` and `profileUrl` are populated only when Google exposes a handle. Thumbtack resolves well, but category and city landing pages can still leave those blank; that is a Google limitation, not a bug.
- The Thumbtack Email Scraper requires the Apify GOOGLE_SERP proxy and cannot run without Apify proxy credentials.
- Free Apify plans are capped at 100 emails per run; paid plans have no cap.
- Results vary with keywords, domains and location, and no volume is guaranteed.

The Thumbtack Email Scraper is not affiliated with, endorsed by or officially supported by Thumbtack.
It reads public search results only and does not access private or gated data.

### Responsible use, GDPR and CAN-SPAM

Most Thumbtack pros are sole traders, so a free-mail address is often personal data in practice as well as in law.
For US recipients, CAN-SPAM expects accurate headers, a valid postal address and a working unsubscribe path.
For EU and UK recipients, GDPR expects a lawful basis, a clear sender identity, a genuine business reason and an easy way to object.

Keep the `query`, `profileUrl` and `foundAt` provenance that every row carries.
Honour opt-outs immediately and suppress them in later runs of the Thumbtack Email Scraper.
This is general information about common obligations rather than legal advice, so check the rules that apply to you.

### FAQ about the Thumbtack Email Scraper

#### How many results should I expect?

A measured live run returned 10 blocks, 10 identity matches, 10 profile URLs and 4 unique emails. Expect excellent identity resolution and a moderate email harvest, and note that no volume is guaranteed.

#### Why does the Thumbtack Email Scraper find an email for only some pros?

Thumbtack is built to route homeowner enquiries through its own messaging system, so many pros never publish an address. The Thumbtack Email Scraper can only surface the ones that do.

#### Does the Thumbtack Email Scraper log into Thumbtack?

No. It never logs in, never uses a Thumbtack API and never opens thumbtack.com. All data comes from publicly indexed Google results.

#### How important is the location field in the Thumbtack Email Scraper?

Very. Thumbtack pros are matched by service area, so one run per metro will beat a single national run every time.

#### Which keywords work best?

Thumbtack's own category names, such as `house cleaning`, `local moving`, `furniture assembly` and `interior painting`.

#### Why are some `username` and `profileUrl` values empty?

The Thumbtack Email Scraper fills those only when Google exposes a handle. Category or city landing pages sometimes show a title without one, so the row keeps `accountName` and leaves the handle blank.

#### What does `possiblyTruncated` mean?

Google's snippet ellipsis touched the email, so the address may be cut short. Verify those rows before sending.

#### How do I raise the Thumbtack Email Scraper email count?

Widen `customDomains` to four or more free-mail providers, raise `maxEmails`, keep `expandQueries` on and run more metros.

#### Does it need the Apify proxy?

Yes. The Thumbtack Email Scraper runs on the Apify GOOGLE_SERP proxy and cannot operate without Apify proxy credentials.

#### Can I run it on the free plan?

Yes, capped at 100 emails per run. Paid plans remove the cap.

#### Are the emails verified?

No. The Thumbtack Email Scraper extracts and normalises what Google shows. Run your own verification before any campaign.

#### Which other home-services Actors should I run alongside?

The [Angi Email Scraper](https://apify.com/leads-scraper/angi-email-scraper) and [Porch Email Scraper](https://apify.com/neuro-scraper/porch-email-scraper) for more US contractors, and the [Bark Email Scraper](https://apify.com/leads-scraper/bark-email-scraper) for UK trades.

### Related Actors

Thirty-six sibling Actors cover the rest of the Business and Professional Directories category that the Thumbtack Email Scraper belongs to.
They share the same input schema, output schema and behaviour, so anything you learn here transfers directly.
For design-led remodelling try the [Houzz Email Scraper](https://apify.com/leads-scraper/houzz-email-scraper), and for a general local fallback the [Yellow Pages Email Scraper](https://apify.com/leads-scraper/yellow-pages-email-scraper).

| Actor | What it collects |
|---|---|
| [Thumbtack Email and Phone Number Scraper](https://apify.com/leads-scraper/thumbtack-email-and-phone-number-scraper) | Emails and phone numbers from Thumbtack |
| [Thumbtack Phone Number Scraper](https://apify.com/leads-scraper/thumbtack-phone-number-scraper) | Public phone numbers from Thumbtack |
| [Angi Email Scraper](https://apify.com/leads-scraper/angi-email-scraper) | Public contact emails from Angi |
| [Bark Email Scraper](https://apify.com/leads-scraper/bark-email-scraper) | Public contact emails from Bark |
| [Better Business Bureau Email Scraper](https://apify.com/leads-scraper/better-business-bureau-email-scraper) | Public contact emails from Better Business Bureau |
| [Bizapedia Email Scraper](https://apify.com/neuro-scraper/bizapedia-email-scraper) | Public contact emails from Bizapedia |
| [Brownbook Email Scraper](https://apify.com/neuro-scraper/brownbook-email-scraper) | Public contact emails from Brownbook |
| [Callupcontact Email Scraper](https://apify.com/neuro-scraper/callupcontact-email-scraper) | Public contact emails from CallUpContact |
| [Capterra Email Scraper](https://apify.com/leads-scraper/capterra-email-scraper) | Public contact emails from Capterra |
| [Clutch Email Scraper](https://apify.com/leads-scraper/clutch-email-scraper) | Public contact emails from Clutch |
| [Crunchbase Email Scraper](https://apify.com/leads-scraper/crunchbase-email-scraper) | Public contact emails from Crunchbase |
| [Cybo Email Scraper](https://apify.com/neuro-scraper/cybo-email-scraper) | Public contact emails from Cybo |
| [Cylex Email Scraper](https://apify.com/neuro-scraper/cylex-email-scraper) | Public contact emails from Cylex |
| [EC21 Email Scraper](https://apify.com/neuro-scraper/ec21-email-scraper) | Public contact emails from EC21 |
| [Europages Email Scraper](https://apify.com/leads-scraper/europages-email-scraper) | Public contact emails from Europages |
| [ExportHub Email Scraper](https://apify.com/neuro-scraper/exporthub-email-scraper) | Public contact emails from ExportHub |
| [FindUsLocal Email Scraper](https://apify.com/neuro-scraper/finduslocal-email-scraper) | Public contact emails from FindUsLocal |
| [Foursquare Email Scraper](https://apify.com/neuro-scraper/foursquare-email-scraper) | Public contact emails from Foursquare |
| [Fyple Email Scraper](https://apify.com/neuro-scraper/fyple-email-scraper) | Public contact emails from Fyple |
| [G2 Email Scraper](https://apify.com/neuro-scraper/g2-email-scraper) | Public contact emails from G2 |
| [Hotfrog Email Scraper](https://apify.com/leads-scraper/hotfrog-email-scraper) | Public contact emails from Hotfrog |
| [Houzz Email Scraper](https://apify.com/leads-scraper/houzz-email-scraper) | Public contact emails from Houzz |
| [Infobel Email Scraper](https://apify.com/neuro-scraper/infobel-email-scraper) | Public contact emails from Infobel |
| [Kompass Email Scraper](https://apify.com/leads-scraper/kompass-email-scraper) | Public contact emails from Kompass |
| [Lacartes Email Scraper](https://apify.com/neuro-scraper/lacartes-email-scraper) | Public contact emails from Lacartes |
| [Manta Email Scraper](https://apify.com/leads-scraper/manta-email-scraper) | Public contact emails from Manta |
| [MapQuest Email Scraper](https://apify.com/neuro-scraper/mapquest-email-scraper) | Public contact emails from MapQuest |
| [N49 Email Scraper](https://apify.com/neuro-scraper/n49-email-scraper) | Public contact emails from N49 |
| [Porch Email Scraper](https://apify.com/neuro-scraper/porch-email-scraper) | Public contact emails from Porch |
| [Scoot Email Scraper](https://apify.com/neuro-scraper/scoot-email-scraper) | Public contact emails from Scoot |
| [Thomasnet Email Scraper](https://apify.com/leads-scraper/thomasnet-email-scraper) | Public contact emails from Thomasnet |
| [Touch Local Email Scraper](https://apify.com/leads-scraper/touch-local-email-scraper) | Public contact emails from Touch Local |
| [TradeIndia Email Scraper](https://apify.com/leads-scraper/tradeindia-email-scraper) | Public contact emails from TradeIndia |
| [Trustpilot Email Scraper](https://apify.com/leads-scraper/trustpilot-email-scraper) | Public contact emails from Trustpilot |
| [Tupalo Email Scraper](https://apify.com/leads-scraper/tupalo-email-scraper) | Public contact emails from Tupalo |
| [Yalwa Email Scraper](https://apify.com/leads-scraper/yalwa-email-scraper) | Public contact emails from Yalwa |
| [Yellow Pages Email Scraper](https://apify.com/leads-scraper/yellow-pages-email-scraper) | Public contact emails from Yellow Pages |
| [Angi Email and Phone Number Scraper](https://apify.com/neuro-scraper/angi-email-and-phone-number-scraper) | Emails and phone numbers from Angi |
| [Bark Email and Phone Number Scraper](https://apify.com/neuro-scraper/bark-email-and-phone-number-scraper) | Emails and phone numbers from Bark |
| [Better Business Bureau Email and Phone Number Scraper](https://apify.com/leads-scraper/better-business-bureau-email-and-phone-number-scraper) | Emails and phone numbers from Better Business Bureau |
| [Bizapedia Email and Phone Number Scraper](https://apify.com/neuro-scraper/bizapedia-email-and-phone-number-scraper) | Emails and phone numbers from Bizapedia |
| [Brownbook Email and Phone Number Scraper](https://apify.com/neuro-scraper/brownbook-email-and-phone-number-scraper) | Emails and phone numbers from Brownbook |

### Leave a review

If the Thumbtack Email Scraper saved you time, please leave a star rating and a short review on
the Actor page.

Reviews are how other buyers judge whether a tool works, and they tell us which features to
build next.

If something did not work, email <neurodata.apify@gmail.com>
instead - bugs get fixed faster than they get complained about.

### Support

Questions, bug reports or a custom build request for the Thumbtack Email Scraper: contact neurodata.apify@gmail.com.

# Actor input Schema

## `keywords` (type: `array`):

Search terms describing the Thumbtack accounts you want (niche, job title, industry).

## `location` (type: `string`):

Optional location phrase added to every query (e.g. "New York").

## `customDomains` (type: `array`):

Only emails ending with one of these domains are collected. With or without the leading @. Each domain is searched separately, so more domains means more results but a longer run - remove some for a faster, narrower search, or add your own (e.g. @company.com).

## `maxEmails` (type: `integer`):

Stop once this many unique emails have been collected.

## `countryCode` (type: `string`):

Two-letter country code for the search proxy (e.g. US, GB, DE). Empty for any.

## `expandQueries` (type: `boolean`):

Search each keyword x domain pair with several phrasings. Recommended - Google caps a single query at ~300 results.

## `queryModifiers` (type: `array`):

Extra words combined with each keyword when Expand queries is on. Tuned for Thumbtack.

## `maxPagesPerQuery` (type: `integer`):

Google rarely returns more than ~30 pages for one query.

## `maxConcurrency` (type: `integer`):

How many queries run in parallel.

## Actor input object example

```json
{
  "keywords": [
    "contractor",
    "handyman"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com",
    "@yahoo.com"
  ],
  "maxEmails": 20,
  "countryCode": "",
  "expandQueries": true,
  "queryModifiers": [
    "email",
    "contact",
    "enquiries",
    "owner",
    "get a quote"
  ],
  "maxPagesPerQuery": 30,
  "maxConcurrency": 5
}
```

# Actor output Schema

## `results` (type: `string`):

Records produced by Thumbtack Email Scraper, stored in the run's default dataset.

# 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 = {
    "keywords": [
        "contractor",
        "handyman"
    ],
    "location": "",
    "customDomains": [
        "@gmail.com",
        "@yahoo.com"
    ],
    "countryCode": "",
    "queryModifiers": [
        "email",
        "contact",
        "enquiries",
        "owner",
        "get a quote"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("leads-scraper/thumbtack-email-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 = {
    "keywords": [
        "contractor",
        "handyman",
    ],
    "location": "",
    "customDomains": [
        "@gmail.com",
        "@yahoo.com",
    ],
    "countryCode": "",
    "queryModifiers": [
        "email",
        "contact",
        "enquiries",
        "owner",
        "get a quote",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("leads-scraper/thumbtack-email-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 '{
  "keywords": [
    "contractor",
    "handyman"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com",
    "@yahoo.com"
  ],
  "countryCode": "",
  "queryModifiers": [
    "email",
    "contact",
    "enquiries",
    "owner",
    "get a quote"
  ]
}' |
apify call leads-scraper/thumbtack-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,leads-scraper/thumbtack-email-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/oW9gugi2yhdUJbEHM/builds/hwmTAjI2HgfuRwo0M/openapi.json