Google Local services API
Find the businesses Google lists in Local Services ads for a service in a US city (plumbers, electricians, cleaners...): up to 20 per request, each with phone, star rating, review count, category, service area and Google profile link.
价格与服务商
Google Local services API 价格:一个 API,2 个可互换的服务商
最便宜的服务商优先响应。如果它失败,下一个会在同一次调用中接手。
试一试
一个请求获取 Google Local services
{
"data": {
"items": [
{
"bid": "a1b2c3d4",
"category": "general",
"cid": "a1b2c3d4",
"highlights": [
"example"
],
"hours": "example",
"image": "https://example.com/image.jpg",
"isOpenNow": true,
"name": "Example title",
"phone": "+1 555-0142",
"pid": "a1b2c3d4",
"position": 1,
"profileUrl": "https://example.com/page",
"rating": 4.6,
"responseTime": "2024-01-15T09:30:00Z",
"reviewCount": 12500,
"serviceArea": "example",
"yearsInBusiness": 2024
}
]
},
"found": true,
"reason": "not_found"
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
一个请求,一种响应结构。
你发送的每个字段和收到的每个字段,都附有真实示例。
最近验证于 2026-10-16 · 可用率和延迟按 30d 统计
请求体
JSON,POST 到这个接口。
- locationstring
Denver, CO
The US city to search, with its state (e.g. Denver, CO or Austin, TX).
- querystring
plumber
The service to find businesses for, in everyday words (e.g. plumber, electrician, house cleaning, roofer).
- limitinteger
5
Maximum number of businesses to return (1-20, default 20). Google lists at most 20 businesses for one service in one city, so there are no further pages.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `yearsInBusiness` or `hours`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be null on a business that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
响应
JSON,每个字段一个示例值。
Businesses Google lists in Local Services ads for the service and location, in Google's order. Populated whenever the provider has data for the entity.
- bidstring
Google Local Services business id (bid). Populated whenever the provider has data for the entity.
- categorystring
Google's service category for the business (e.g. Plumbers, Electricians). Populated whenever the provider has data for the entity.
- cidstring
Google customer id (cid) of the business. Populated whenever the provider has data for the entity.
- highlightsstring[]可设为必填
Selling points the business lists, such as Flat rate pricing or Free in-home estimate. Null when this source does not report them.
- hoursstring可设为必填
Opening status as Google shows it at request time (e.g. Open 24 hours). Null when this source does not report it.
- imagestring可设为必填
Business logo or photo URL. Null when the business has none or this source does not report it.
- isOpenNowboolean可设为必填
Whether the business was open when the request ran, as Google shows it. Null when this source does not report it.
- namestring
Business name. Populated whenever the provider has data for the entity.
- phonestring
Business phone number in E.164 format (e.g. +17205550123). Populated whenever the provider has data for the entity.
- pidstring
Google Local Services provider id (pid). Null when Google assigns none, which is common.
- positioninteger
1-based position of the business in Google's list. Populated whenever the provider has data for the entity.
- profileUrlstring
The business's Google Local Services profile page. Populated whenever the provider has data for the entity.
- ratingnumber
Average Google star rating out of 5. Null for a business with no reviews yet. Populated whenever the provider has data for the entity.
- responseTimestring可设为必填
How quickly the business usually replies, as Google shows it (e.g. Typically replies in 15 min). Null when Google shows none or this source does not report it.
- reviewCountinteger
Number of Google reviews behind the rating. Null for a business with no reviews yet. Populated whenever the provider has data for the entity.
- serviceAreastring
The area Google says the business serves (e.g. Denver). Populated whenever the provider has data for the entity.
- yearsInBusinessinteger可设为必填
Years in business as Google shows it ("8+ years in business" reads 8). Null when Google shows none or this source does not report it.
- foundboolean
True when Google listed at least one business for the service and location.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
常见问题
关于 Google Local services API
AnyAPI 的 Google Local services API 只需一次 POST 请求 /v1/run/google.local_services,就以统一格式的 JSON 返回 Google 数据。Find the businesses Google lists in Local Services ads for a service in a US city (plumbers, electricians, cleaners...): up to 20 per request, each with phone, star rating, review count, category, service area and Google profile link.AnyAPI 会在 2 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$0.85 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Google Local services API 调用中有 100.0% 成功,响应时间中位数为 7.5 秒,共测量 1 次调用。