How to Scrape Thumbtack Listings with an API (the Authorized Way)

Short answer: do not scrape Thumbtack’s consumer website with a bot unless Thumbtack has given you prior written consent. For an authorized integration, use Thumbtack’s Partner Platform Businesses Search API. It creates a short-lived search context from a ZIP code, service category and request-form details, then returns matching professionals (“businesses” in the API terminology). Access requires OAuth 2.0 credentials and the scopes assigned to your application; it is not documented as an unrestricted export of every listing.

Scraping pages versus using Thumbtack’s API

People often use “scrape” to mean “retrieve listings programmatically.” Technically, that could mean downloading HTML from thumbtack.com, or it could mean calling a supported API. The distinction matters:

#	Preview	Product	Price
1		Visa Virtual eGift Card	$206.95	Buy on Amazon
2		Visa Physical Gift Card $200 (plus $6.95 Purchase Fee)	$206.95	Buy on Amazon
3		Instacart Physical Gift Card - $100	$100.00	Buy on Amazon
4		STAPLES Physical Gift Card - $100	$100.00	Buy on Amazon
5		DoorDash Physical Gift Cards	$45.00	Buy on Amazon

Thumbtack’s partner documentation describes two broad paths. Marketplace integrations help customers discover services and send requests. Pro integrations support professionals with leads, messages, profiles and customer activity. The Businesses Search API belongs to the marketplace path. Do not assume that a marketplace search token grants access to pro-side records, reviews, phone numbers or every other API family.

What the Businesses Search API does

The documented route is /api/v4/businesses/search. A search context holds the information needed for a professional search, including:

#1 Best Overall

Visa Virtual eGift Card

• Visa Virtual eGift Cards are designed for online use only. Gift Cards are subject to Terms and Conditions: a.co/5bw3qXJ
• When you access your Visa Virtual eGift Card for the first time, you’ll need to register your name, address, phone number, and email address via activationspot.com. These details should also be used as your billing address for online purchases, as many merchants require address verification for purchase authorization.
• This Visa Virtual eGift Card is non-reloadable. No cash or ATM access. Visa Virtual eGift Cards are emailed active.
• Funds do not expire but your Visa Virtual eGift Card has a ‘valid thru’ date (9 years from date of purchase). If funds remain after this date has passed, please call the Toll Free number found on your Visa Virtual eGift Card for a replacement card. A one-time purchase fee applies at the time of checkout.
• This item is not eligible for refund, resale, or return. Available for sale within the United States only. Not available to residents of Puerto Rico, Hawaii, New Mexico, South Dakota, West Virginia and the US Virgin Islands.

$206.95

Buy on Amazon

• A ZIP code or other location input accepted by your provisioned integration.
• A category ID representing the service.
• Request-form details that describe the customer’s job.

The normal flow is context-based rather than “download all listings.” You construct a context for a user’s need, call the businesses search route, and use the returned matches in the product and purpose approved for your application. The material available publicly does not establish pagination limits, rate limits, a complete response schema, or a right to run bulk extraction. Confirm those details in the current reference available to your partner account.

Expected integration sequence

1. Choose the marketplace integration path and verify that your use case is eligible.
2. Register an application with Thumbtack and obtain a client ID, client secret and approved scopes.
3. Implement OAuth 2.0 using a supported library. Thumbtack’s guide says manual OAuth implementations are not explicitly supported.
4. Obtain an access token, build the documented search context, and call /api/v4/businesses/search.
5. Display or process only the fields and purposes covered by your scopes, user disclosures and agreement with Thumbtack.
6. Delete or retain API data according to the applicable terms, privacy law and your CRM obligations.

Authentication: OAuth 2.0, scopes and token lifetime

Thumbtack states that its APIs “utilize and strictly adhere to the OAuth 2.0 protocol.” Your application receives a client ID, client secret and a list of scopes. Each endpoint reference specifies the scope it requires, so request only the scopes your feature needs.

Token handling

• The documented access-token lifetime is one hour. Treat an expired-token response as a normal refresh event, not as a reason to create another application.
• In the authorization-code flow, requesting offline_access can provide refresh-token behavior. Whether you receive that scope and how it behaves depends on the credentials and consent granted to your partner application.
• Keep client secrets and refresh tokens on a server-side secret store. Never place them in browser JavaScript, mobile binaries or source control.

Illustrative request skeleton

The following is a wiring example, not a guaranteed production payload. Replace the placeholders with the exact token URL, context fields, headers and body shown in the current Thumbtack reference for your account. The public material does not provide a universal token endpoint, sample credentials or a complete search schema, so inventing those values would be unsafe.

import os
import requests

access_token = os.environ["THUMBTACK_ACCESS_TOKEN"]
search_url = os.environ["THUMBTACK_API_BASE"].rstrip("/") + "/api/v4/businesses/search"

payload = {
    # Use the field names and structure in your partner reference:
    "search_context": {
        "zip_code": "10001",
        "category_id": os.environ["THUMBTACK_CATEGORY_ID"],
        "request_form_details": {
            "description": "Move-out cleaning",
        },
    }
}

response = requests.post(
    search_url,
    headers={
        "Authorization": f"Bearer {access_token}",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json=payload,
    timeout=30,
)
response.raise_for_status()
print(response.json())

Use the exact property names, HTTP method and context-creation step required by the reference exposed to your partner account. This skeleton demonstrates safe token placement and error handling; it is not a claim that the shown JSON is the complete current schema.

Rank #2

Visa Physical Gift Card $200 (plus $6.95 Purchase Fee)

• Gift Cards are shipped active and ready for use.
• This card is non-reloadable. No cash or ATM access. Funds do not expire. If available funds remain on your card after the valid thru date has passed, please call customer service for a replacement card. A one-time purchase fee applies at the time of checkout. No fees after purchase.
• To access your card information safely, type the complete website address shown on your Gift Card (MyGift.GiftCardMall.com) directly into your browser's address bar. Don't use search engines or shortened versions of the website address, as these may lead you to fake or fraudulent sites. Do not provide any Gift Card details (example: Card Number) to someone you do not know or trust. If you believe you've reached an illegitimate website, contact cardholder service at 1-888-524-1283. Be cautious of phishing sites, there are a variety of scams in which fraudsters try to trick others into paying with gift cards.
• To report your Lost or Stolen Physical Visa Card, call Customer Service 24/7 at 1 (888) 524-1283 to cancel your Gift Card as soon as you can. You will be asked to provide the Gift Card number and other identifying information.
• Use your Visa Gift Card in the U.S. everywhere Visa debit cards are accepted, including online.

$206.95

Buy on Amazon

Building a compliant listing workflow

Define the user’s purpose first

Record why a person is searching, which service they selected and the location they supplied. A narrowly defined purpose makes it easier to request the correct scope and avoid collecting unrelated personal data.

Minimize stored fields

Thumbtack’s privacy materials identify names, email addresses, addresses and phone numbers as personal-data categories in the platform context. Do not copy or republish those fields merely because an API response contains them. Store only what your approved feature needs, restrict internal access and document retention.

CRM responsibilities

Thumbtack’s API terms describe CRM data as processed on behalf of the service professional. They require destruction within five business days after the CRM stops using the API, or after Thumbtack’s reasonable request, subject to the terms’ stated exceptions. Build deletion jobs and an audit trail before going live; do not treat an indefinitely retained data warehouse as the default.

Use results as a search response, not a directory dump

Render matches for the requesting customer or carry out the specifically approved workflow. The documentation reviewed does not establish that you may create a permanent, searchable copy of all professionals, sell the data, or run an unrestricted export. Ask Thumbtack for written confirmation if your design needs any of those behaviors.

Rank #3

Instacart Physical Gift Card - $100

• GROCERY SHOPPING MADE EASY: Get your entire grocery store list delivered in as fast as 30 minutes. Prefer pick up? Order your groceries online, pick up at your local store, and skip the fees and tipping.
• GROCERY COUPONS AND DEALS: Discover exclusive deals and grocery coupons found only on the Instacart app.
• SHOP GROCERY STORES NEAR YOU: Instacart connects you with over 85,000 supermarkets and stores across North America.
• THOUGHTFUL GIFT: Share the gift of time by taking a chore off a friend’s or family’s to-do list. Perfect for new parents!
• Redeem in the app: Sign up for Instacart or log into your existing account Enter the main menu Tap Credits, promos & gift cards Enter the code Redeem on the website: Sign up for Instacart or log into your existing account Click Account or your name Click Add promo or gift card Enter the code

$100.00

Buy on Amazon

What is and is not established about access

• Established: Thumbtack documents a Businesses Search API, OAuth 2.0 authentication, route-specific scopes and a short-lived search context.
• Not established: that every developer can obtain production credentials, that a standalone research project qualifies, or that the API provides complete listings, unlimited pagination or bulk export.
• Operational condition: API access may be removed and the API terms make no warranty that the service will remain available.

Before building a commercial dependency, review the current Partner Platform onboarding material and ask Thumbtack to confirm eligibility, scopes, retention rules and any quotas for your exact application.

Common failure modes and fixes

401 or 403 responses

A 401 usually means the token is missing, malformed or expired. Obtain a fresh token and verify the Authorization: Bearer header. A 403 commonly indicates that the application lacks the route’s required scope or that the account is not approved for the integration path. Do not work around a 403 by switching to HTML scraping; ask Thumbtack to provision the correct scope.

Invalid context or category errors

Check that the category identifier is one supplied by the categories API or your partner documentation, that the ZIP code is valid for the intended market, and that every required request-form field is present. Log a redacted request ID and validation message, not customer personal data.

Expired tokens during long-running jobs

Access tokens last one hour according to the authentication guide. Refresh before dispatching a batch, serialize refresh-token use to avoid races, and retry the original request once with the new token. If refresh fails, require a new authorization rather than repeatedly retrying.

Rank #4

STAPLES Physical Gift Card - $100

• Staples Gift Cards - Giving the perfect gift has never been easier.
• Staples Gift Cards offer thousands of choices in one easy location. Easy for you. Perfect for them.
• Gift Cards are redeemable only at Staples US Retail stores.
• No returns and no refunds on gift cards.

$100.00

Buy on Amazon

Unexpectedly empty results

An empty result can reflect category/location availability or an incomplete request context. Recheck the user’s inputs and the category mapping. Do not infer that an empty response authorizes a fallback crawl of the public site.

Rate, schema or pagination questions

The reviewed reference does not state universal limits or a complete schema. Read the version of the API reference attached to your credentials and contact Thumbtack for contractual limits. Implement bounded retries with exponential backoff for transient 5xx responses, and alert on sustained schema changes instead of silently dropping fields.

Performance, reliability and cost planning

Cache carefully

Cache category metadata and your own normalized configuration, but be conservative with professional results. Freshness, privacy, deletion obligations and Thumbtack’s terms should determine the cache lifetime. Never let a cache turn a user search into an unapproved directory.

Keep requests observable

• Record timestamp, endpoint, HTTP status, latency and a correlation ID.
• Redact tokens, secrets, addresses, phone numbers and free-text job descriptions from logs.
• Track token refreshes, validation failures and consent state separately from result content.
• Use timeouts and bounded retries; make retries idempotent from your application’s perspective.

Plan for revocation

Because Thumbtack can remove API access and does not guarantee availability, provide a user-facing degraded state. Queue no more work than you can delete or replay within your approved retention period, and keep a switch that disables calls without redeploying the whole product.

Best Value

DoorDash Physical Gift Cards

• This item contains 3 separate $15 gift cards.
• Get thousands of restaurants, convenience stores, pet stores, grocery stores, gifts, and more at your fingertips.
• Easy ordering, order customizations, and real-time tracking
• Pickup, group order, and scheduled delivery options available
• To redeem, log in or create an account, select "Credits and Gift Cards" and enter the gift card number in to add the balance to your account

$45.00

Buy on Amazon

Or skip the browser setup

If your actual requirement is a visual record of a Thumbtack page that you are authorized to capture—not a structured listing integration—ScreenshotNeo provides a single-call website screenshot API. It accepts cookie or consent banners like a visitor and removes more than 60 known consent platforms, newsletter popups and chat widgets before capture; each cleanup step can be disabled. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads and cache hits are not billed, and response headers identify the page verdict and billing result. Its MCP server exposes take_screenshot, get_page_info and capture_pdf to Claude, Cursor and other MCP clients.

For parameters, authentication and PDF options, see the ScreenshotNeo documentation.

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://www.thumbtack.com -o shot.webp

import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://www.thumbtack.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)

const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://www.thumbtack.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);

The Free plan includes 1,000 screenshots per month with no card. Paid plans start at $5 for 3,000 shots; every feature is available on every plan. Use screenshots only where your authorization and Thumbtack’s terms permit. Sign up for the free plan.

When to choose each approach

FAQ

Can I call /api/v4/businesses/search without a partner account?

The documentation describes application credentials and scopes, but it does not establish open, anonymous access. Confirm eligibility with Thumbtack.

Is the API a replacement for a data-licensing agreement?

No. API credentials, terms, privacy obligations and any separate commercial agreement all still apply to your intended use.

Can I publish the professionals’ phone numbers or email addresses?

Do not do so by default. Personal-data use and publication must be covered by your authorization, disclosures, privacy law and Thumbtack’s terms.

The Bottom Line

For programmatic Thumbtack searches, pursue the authorized OAuth-protected Businesses Search API and treat its results as purpose-limited search data. Do not automate the consumer site without Thumbtack’s prior written consent, and confirm eligibility, scopes, limits and retention duties before relying on the integration.

Quick Recap

Bestseller No. 1

Visa Virtual eGift Card

$206.95

Bestseller No. 2

Visa Physical Gift Card $200 (plus $6.95 Purchase Fee)

Gift Cards are shipped active and ready for use.

$206.95

Bestseller No. 3

Instacart Physical Gift Card - $100

$100.00

Bestseller No. 4

STAPLES Physical Gift Card - $100

Staples Gift Cards - Giving the perfect gift has never been easier.; Gift Cards are redeemable only at Staples US Retail stores.

$100.00

Bestseller No. 5

DoorDash Physical Gift Cards

This item contains 3 separate $15 gift cards.; Easy ordering, order customizations, and real-time tracking

$45.00

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.