# Google Local Services Ads Provider Finder (`xyrelith-data/google-local-services-ads`) Actor

Find Google Local Services Ads providers by trade and city or ZIP. Returns ratings, review counts and histograms, years in business, hours, highlights, response times, phone numbers, stable Google IDs and profile links, with optional services, verification and review topics.

- **URL**: https://apify.com/xyrelith-data/google-local-services-ads.md
- **Developed by:** [Xyrelith Data](https://apify.com/xyrelith-data) (community)
- **Categories:** Lead generation, Automation, SEO tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.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

## Google Local Services Ads Provider Finder

Find the Google Local Services Ads (LSA) providers Google shows for a trade in a city or ZIP code. This actor reads the public Local Services results page and returns one clean row per provider: business name, category, rating, review count and star histogram, years in business, service area, hours, highlights, response time, phone number, stable Google IDs and profile links.

Use it for local lead research, competitor tracking, market sizing and verifying who is actually buying Local Services ads in a market.

### What you get

| Field | Meaning |
|---|---|
| `customerId`, `businessId`, `providerId` | Google's stable advertiser, business and provider IDs (the placeholder provider ID is omitted). |
| `name`, `category`, `serviceArea` | Business name, LSA category and the city or area Google prints on the card. |
| `rating`, `reviewCount`, `reviewHistogram` | Average stars, total reviews and the 1-5 star breakdown. |
| `yearsInBusiness`, `openedYear` | Google's tenure line, split into a number and an opening year. |
| `hoursSummary`, `isOpenNow`, `weeklyHours` | The card's hours line, current open state and the full weekly table. |
| `highlights` | Google's marketing highlights, e.g. "24/7 emergency service", "Family-owned & operated". |
| `responseTime` | Google's reply-time label, e.g. "Typically replies in 15 min". |
| `phone`, `phoneRegionCode` | The published call-tracking number in E.164 format and its region. |
| `profileUrl`, `bookingUrl`, `messagingUrl`, `imageUrl` | Google profile, booking, messaging and photo links where the card exposes them. |
| `googleVerified`, `verificationLabel`, `trustBadge` | Verification shown on the provider's profile (profile details mode). |
| `services`, `serviceGroups` | The services the provider offers, grouped by trade (profile details mode). |
| `address`, `mapsUrl`, `serviceAreaCounties`, `serviceAreaDetails` | Address and coverage details from the profile (profile details mode). |
| `reviewTopics`, `reviewSnippets`, `photoCount`, `details` | Google review topics, short review snippets, photo count and profile detail labels (profile details mode). |
| `position`, `searchQuery`, `location`, `countryCode`, `language`, `sourceUrl`, `scrapedAt` | Where the row came from and its rank in that search. |

Every record is omit-empty: a field Google does not publish for a provider is left out, never sent as `null`. Profile-only fields appear when Google shows them; a missing address or booking link means Google did not publish it for that provider.

### Modes

#### Search by trade and location (default)

Pick one or more Google LSA categories, optionally add free-text service terms, and list the cities, districts or ZIP codes to search. Each trade is searched in every location, so 3 trades x 4 cities runs 12 searches.

```json
{
  "mode": "search",
  "categories": ["plumber", "electrician"],
  "services": [],
  "locations": ["Austin, TX", "78701"],
  "maxItems": 50
}
```

#### Run full queries

Paste complete searches exactly as a customer would type them. The country is detected from each query.

```json
{
  "mode": "byQuery",
  "searchQueries": ["personal injury lawyer in Chicago, IL", "house cleaning in Seattle, WA"],
  "maxItems": 50
}
```

#### Fetch exact Local Services URLs

Paste `google.com/localservices/prolist` URLs, or a `/localservices/profile` URL to return that single provider. Useful for reproducing a search or refreshing one profile.

```json
{
  "mode": "byUrls",
  "startUrls": ["https://www.google.com/localservices/prolist?q=plumber+in+austin+tx&hl=en&gl=us&src=1"]
}
```

### Filters

- **Minimum rating** asks Google for 2.0+ through 4.5+ providers.
- **Hours** asks Google for providers open now, open 24 hours or open on a chosen weekday.
- **Minimum reviews** and **minimum years in business** filter locally. Minimum years uses Google's tenure line, or the opened year when the tenure line is absent.
- **Require a phone number** drops providers without a published number.
- **Verified by Google only** keeps providers whose profile carries Google's verification statement; it turns profile details on automatically.
- **Include profile details** adds one extra request per provider (capped by **Maximum profile lookups**) for services, verification, address, review topics and snippets. It is off by default so the daily test and small runs stay cheap. Profile enrichment is best-effort: if Google rate-limits one profile, that provider keeps its listing fields and the run reports how many profiles were enriched.
- **Maximum providers** caps the whole run. Google returns at most 20 providers per search, so raise the cap and add more trades or locations for a bigger list.

### Countries and languages

Local Services Ads run in the United States, Canada, the United Kingdom, Ireland, Germany, France, Italy, Spain, Austria, Belgium and Switzerland. Leave **Country** on auto to detect it from the location, or force a market. The actor matches the proxy exit to the market automatically. Language controls the interface language of the results; English works in every market.

### How many results can I get?

Google serves **up to 20 providers per trade per location**. That is Google's own limit: there is no page 2 or offset parameter. To build a larger list, add more categories, free-text service terms or nearby cities and ZIP codes. The actor removes duplicate providers across all searches, keyed on Google's customer ID.

### Input reference

| Input | Default | Purpose |
|---|---|---|
| `mode` | `search` | `search`, `byQuery` or `byUrls`. |
| `categories` | `["plumber"]` | One or more of the 111 Google LSA categories. |
| `services` | `[]` | Extra free-text trades searched in every location. |
| `locations` | `["Austin, TX"]` | Cities, districts or ZIP codes. |
| `searchQueries` | `[]` | Full queries for `byQuery`. |
| `startUrls` | `[]` | Listing or profile URLs for `byUrls`. |
| `countryCode` | `auto` | Auto-detect or force one of the 11 LSA markets. |
| `language` | `en` | Interface language. |
| `minRating` | `any` | Any, 2.0+, 2.5+, 3.0+, 3.5+, 4.0+ or 4.5+. |
| `hours` | `any` | Any, open now, open 24 hours or a weekday. |
| `minReviews` | `0` | Minimum review count. |
| `minYearsInBusiness` | `0` | Minimum years in business. |
| `requirePhone` | `false` | Drop providers without a phone. |
| `verifiedOnly` | `false` | Keep only Google-verified profiles. |
| `includeProfileDetails` | `false` | Fetch services, verification, address and review topics. |
| `maxProfileLookups` | `40` | Cap on profile requests. |
| `maxItems` | `50` (prefill `3`) | Cap on unique providers in the run. |

### Output example

```json
{
  "recordType": "provider",
  "customerId": "264203903",
  "businessId": "2509568154",
  "providerId": "2511224752",
  "name": "Roto-Rooter Plumbing & Water Cleanup",
  "category": "Plumbers",
  "rating": 4.8,
  "reviewCount": 3478,
  "reviewHistogram": {"1": 149, "2": 32, "3": 32, "4": 95, "5": 3170},
  "yearsInBusiness": 91,
  "openedYear": 1935,
  "serviceArea": "Austin",
  "hoursSummary": "Open 24 hours",
  "isOpenNow": true,
  "weeklyHours": {"Monday": "Open 24 hours", "Tuesday": "Open 24 hours", "Wednesday": "Open 24 hours", "Thursday": "Open 24 hours", "Friday": "Open 24 hours", "Saturday": "Open 24 hours", "Sunday": "Open 24 hours"},
  "highlights": ["24/7 emergency service", "150+ bookings near you"],
  "responseTime": "Typically replies in a few min",
  "phone": "+15123626777",
  "phoneRegionCode": "US",
  "profileUrl": "https://www.google.com/localservices/profile?...",
  "searchQuery": "plumber in Austin, TX",
  "location": "Austin, TX",
  "countryCode": "US",
  "language": "en",
  "position": 1,
  "sourceUrl": "https://www.google.com/localservices/prolist?q=plumber+in+Austin%2C+TX&hl=en&gl=us&src=1",
  "scrapedAt": "2026-11-15T00:00:00+00:00"
}
```

### Use cases

- Build a list of home-service and professional businesses already paying for Google leads.
- Track which providers hold the top Local Services slots in a metro week over week.
- Compare ratings, review volume and tenure across a market.
- Audit Google Verified coverage and the services each provider advertises.
- Feed CRM, spreadsheet or BI pipelines with clean provider rows.

### Data source and fair use

The actor reads Google's public Local Services results and profile pages, logs nothing in, and uses no Google account, API key or cookie. It paces requests and retries rate-limited responses. You are responsible for lawful use of the data, including any outreach rules that apply in your market.

### FAQ

**Is this the official Google Local Services Ads API?**
No. Google's official Local Services API is for advertisers managing their own accounts and leads. This actor reads the public listing that any searcher can see.

**Why did a search return nothing?**
The market may have no active LSA advertisers for that trade, the category may not be eligible there, or your filters may be too strict. Try a larger city, a plainer trade word and clear the filters.

**Why are there only 20 rows for one search?**
That is Google's per-search limit. Add more trades, ZIP codes or nearby cities.

**Why is there no website field?**
Local Services cards do not publish a business website. The actor does not guess one.

**Where is the Google Guaranteed or Google Screened badge?**
Google consolidated the old badges into a single "Verified by Google" statement on provider profiles. With profile details on, the actor returns `googleVerified`, `verificationLabel` and `trustBadge` when Google shows it.

**Do I need a proxy?**
No. The actor selects the right proxy for the market automatically.

**Why do some fields differ between providers?**
Google publishes different amounts for each advertiser. Omit-empty is deliberate: a missing field means Google did not show it for that provider.

# Actor input Schema

## `mode` (type: `string`):

Search by trade and location, run full queries, or fetch exact Google Local Services URLs.

## `categories` (type: `array`):

Google's LSA categories. Each selected category is searched in every location.

## `services` (type: `array`):

Free-text trades added to the selected categories, e.g. 'water heater repair' or 'roof repair'. Each is searched in every location.

## `locations` (type: `array`):

Cities, districts or ZIP codes, e.g. 'Austin, TX', 'Toronto, ON', 'London, UK' or '78701'. Include the state, province or country.

## `searchQueries` (type: `array`):

Complete searches such as 'plumber in Austin, TX' or 'personal injury lawyer in Chicago, IL'. The country is detected from each query.

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

google.com/localservices/prolist or /profile URLs. Profile URLs return that single provider.

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

Country used for Google's market and the proxy exit. Auto detects from the location (US when unclear).

## `language` (type: `string`):

Interface language for result text. English works in every market.

## `minRating` (type: `string`):

Ask Google for providers at or above this rating. 'Any' keeps every provider.

## `hours` (type: `string`):

Only providers open now, open 24 hours, or open on a given weekday.

## `minReviews` (type: `integer`):

Skip providers with fewer reviews. 0 keeps all.

## `minYearsInBusiness` (type: `integer`):

Skip providers with fewer years in business. 0 keeps all.

## `requirePhone` (type: `boolean`):

Drop providers without a published call-tracking number.

## `verifiedOnly` (type: `boolean`):

Keep only providers whose profile says they are verified by Google. Turns on profile details automatically.

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

Fetch each provider's LSA profile for services offered, Google verification, address, review topics and snippets.

## `maxProfileLookups` (type: `integer`):

Cap on profile requests per run when profile details are enabled.

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

Stop after this many unique providers across all searches.

## Actor input object example

```json
{
  "mode": "search",
  "categories": [
    "plumber"
  ],
  "services": [],
  "locations": [
    "Austin, TX"
  ],
  "searchQueries": [],
  "startUrls": [],
  "countryCode": "auto",
  "language": "en",
  "minRating": "any",
  "hours": "any",
  "minReviews": 0,
  "minYearsInBusiness": 0,
  "requirePhone": false,
  "verifiedOnly": false,
  "includeProfileDetails": false,
  "maxProfileLookups": 0,
  "maxItems": 3
}
```

# Actor output Schema

## `providers` (type: `string`):

Dataset containing all scraped Google Local Services Ads providers.

# 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 = {
    "mode": "search",
    "categories": [
        "plumber"
    ],
    "services": [],
    "locations": [
        "Austin, TX"
    ],
    "searchQueries": [],
    "startUrls": [],
    "countryCode": "auto",
    "language": "en",
    "minRating": "any",
    "hours": "any",
    "minReviews": 0,
    "minYearsInBusiness": 0,
    "requirePhone": false,
    "verifiedOnly": false,
    "includeProfileDetails": false,
    "maxProfileLookups": 0,
    "maxItems": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("xyrelith-data/google-local-services-ads").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 = {
    "mode": "search",
    "categories": ["plumber"],
    "services": [],
    "locations": ["Austin, TX"],
    "searchQueries": [],
    "startUrls": [],
    "countryCode": "auto",
    "language": "en",
    "minRating": "any",
    "hours": "any",
    "minReviews": 0,
    "minYearsInBusiness": 0,
    "requirePhone": False,
    "verifiedOnly": False,
    "includeProfileDetails": False,
    "maxProfileLookups": 0,
    "maxItems": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("xyrelith-data/google-local-services-ads").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 '{
  "mode": "search",
  "categories": [
    "plumber"
  ],
  "services": [],
  "locations": [
    "Austin, TX"
  ],
  "searchQueries": [],
  "startUrls": [],
  "countryCode": "auto",
  "language": "en",
  "minRating": "any",
  "hours": "any",
  "minReviews": 0,
  "minYearsInBusiness": 0,
  "requirePhone": false,
  "verifiedOnly": false,
  "includeProfileDetails": false,
  "maxProfileLookups": 0,
  "maxItems": 3
}' |
apify call xyrelith-data/google-local-services-ads --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,xyrelith-data/google-local-services-ads"
        }
    }
}
```

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/FiX3VWORyMdXHSiTR/builds/RYxaGklxoRk317cBC/openapi.json
