# Google Local Services Search

Search the Local Services block Google shows for a service query (for example "plumber near Chicago, IL") and get the advertised providers as structured local_ads. Each ad carries the business name, rating and review count, service type, years in business, location, opening hours, phone number and the Google place id. The response mirrors SerpApi google_local_services naming. Coverage is the Google Search Local Services block for US-market queries only: the badge (Google Guaranteed or Screened), the service area and the thumbnail are not present in that markup, and no pagination exists. Only the q, hl and gl parameters are supported. Requests that Google answers with a block page, a captcha, a consent page or a page without the block fail with a non-billable 503.

- **Documentation:** [https://scrappa.co/docs/google-local-services-api/google_local_services_search](https://scrappa.co/docs/google-local-services-api/google_local_services_search)
- **API group:** Google Local Services API
- **Endpoint:** `GET https://scrappa.co/api/google-local-services/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | Yes | Service and location, for example "plumber near Chicago, IL" |
| `hl` | string | No | Interface language code (e.g., en, de) |
| `gl` | string | No | Country code (e.g., us, de) |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/google-local-services/search?q=plumber+near+Chicago%2C+IL&hl=en&gl=us"
```

## Example response

```json
{
    "search_parameters": {
        "q": "plumber near Chicago, IL",
        "hl": "en",
        "gl": "us"
    },
    "local_ads": [
        {
            "title": "Rescue Plumbing",
            "rating": 4.9,
            "review_count": 1600,
            "service_type": "Plumber",
            "years_in_business": 7,
            "location": "Chicago, IL",
            "hours": "Open 24 hours",
            "phone": "(773) 219-6071",
            "website": null,
            "place_id": "10140420633749198317",
            "sponsored": false
        },
        {
            "title": "Goode Plumbing",
            "rating": 4.8,
            "review_count": 2700,
            "service_type": "Plumber",
            "years_in_business": 20,
            "location": "Chicago, IL",
            "hours": "Open 24 hours",
            "phone": "(773) 280-8496",
            "website": null,
            "place_id": "10886154194927970993",
            "sponsored": false
        }
    ],
    "response_time_ms": 1160
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | One or more query parameters failed validation. |
| 503 | Local Services Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)