Google Business Search Keywords API
The Google Business Search Keywords API returns the search terms people used to find a connected Google Business Profile, together with impressions for each term over the requested number of completed months. Use it to see which queries surfaced the profile and to compare relative demand across terms without treating low-volume figures as exact counts.
Request
Call the endpoint with the integration ID for the location as accountId. The months parameter controls how many completed months to include, from 1 to 18, and defaults to 1 when omitted. Google only exposes completed months, so the current month is not available yet and should not be expected in the returned range. Send the access key in the x-access-key header on every request.
Query parameters
The accountId value is the integration ID of the location obtained from list_integrations. Before calling, check that the ID you plan to use corresponds to the intended connected location. The months value is an integer; values outside the 1 to 18 range are outside the documented contract and should be corrected before retrying. Check the returned startMonth and endMonth to confirm the actual window that was covered, rather than assuming it matches the current calendar period.
Response and interpretation
The response reports success, the startMonth and endMonth of the covered range, and a keywords array. Each entry contains a keyword, an impressions count, and an isLowerBound flag. Keywords are sorted by impressions, highest first, so the first entries represent the terms with the largest reported counts. For entries where isLowerBound is set to true, read impressions as a floor value for a low-volume term — for example, 15 or more — rather than a precise total, and display or aggregate it that way. When isLowerBound is false, impressions is the reported count for that term. This request costs 1 credit as stated in the source contract.
| Parameter | Type | Required | Description |
|---|---|---|---|
| accountId | string | Yes | Integration ID of the location from list_integrations |
| months | integer | No | Number of completed months to include (1-18, default 1) |
Exact source contract; origin modularized as {{API_BASE_URL}}.
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the request succeeded |
| startMonth | string | Start of the requested month range, for example 2026-10 |
| endMonth | string | End of the requested month range, for example 2026-10 |
| keywords | array | Search terms sorted by impressions, highest first |
| keyword | string | Individual search term |
| impressions | number | Impression count; a floor value when isLowerBound is true |
| isLowerBound | boolean | True when impressions is a floor value for a low-volume term, not an exact count |
Exact source contract fields.
| Situation | How to interpret or check |
|---|---|
| Current month requested | Only completed months are available; verify startMonth and endMonth in the response. |
| isLowerBound is true | Treat impressions as a floor value, for example 15 or more, not an exact count. |
| Comparing terms | Keywords are sorted by impressions, highest first; do not re-sort floor values as exact counts. |
| Missing or wrong accountId | Use the integration ID of the location from list_integrations for a connected Google Business Profile. |
| months outside 1-18 | Correct months to an integer from 1 to 18; default is 1 when omitted. |
| Cost | This request costs 1 credit as stated in the source contract. |
Derived from documented completed-month, lower-bound, sorting, and credit conditions.
GET {{API_BASE_URL}}/v1/googlebusiness/search-keywords?accountId=INTEGRATION_ID&months=1
x-access-key: YOUR_ACCESS_KEY{
"success": true,
"startMonth": "2026-10",
"endMonth": "2026-10",
"keywords": [
{ "keyword": "fabricio clinic", "impressions": 80, "isLowerBound": false },
{ "keyword": "hair implant", "impressions": 39, "isLowerBound": false },
{
"keyword": "plastic surgery near me",
"impressions": 15,
"isLowerBound": true
}
]
}GET /v1/googlebusiness/search-keywords?accountId=INTEGRATION_ID&months=1
x-access-key: YOUR_ACCESS_KEY