Skip to content

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.

Query parameters
ParameterTypeRequiredDescription
accountIdstringYesIntegration ID of the location from list_integrations
monthsintegerNoNumber of completed months to include (1-18, default 1)

Exact source contract; origin modularized as {{API_BASE_URL}}.

Response fields
FieldTypeDescription
successbooleanWhether the request succeeded
startMonthstringStart of the requested month range, for example 2026-10
endMonthstringEnd of the requested month range, for example 2026-10
keywordsarraySearch terms sorted by impressions, highest first
keywordstringIndividual search term
impressionsnumberImpression count; a floor value when isLowerBound is true
isLowerBoundbooleanTrue when impressions is a floor value for a low-volume term, not an exact count

Exact source contract fields.

Failure and interpretation checks
SituationHow to interpret or check
Current month requestedOnly completed months are available; verify startMonth and endMonth in the response.
isLowerBound is trueTreat impressions as a floor value, for example 15 or more, not an exact count.
Comparing termsKeywords are sorted by impressions, highest first; do not re-sort floor values as exact counts.
Missing or wrong accountIdUse the integration ID of the location from list_integrations for a connected Google Business Profile.
months outside 1-18Correct months to an integer from 1 to 18; default is 1 when omitted.
CostThis request costs 1 credit as stated in the source contract.

Derived from documented completed-month, lower-bound, sorting, and credit conditions.

Request: Google Business Search Keywords API
GET {{API_BASE_URL}}/v1/googlebusiness/search-keywords?accountId=INTEGRATION_ID&months=1
x-access-key: YOUR_ACCESS_KEY
Example response
{
	"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
		}
	]
}
Endpoint request 1
GET /v1/googlebusiness/search-keywords?accountId=INTEGRATION_ID&months=1
x-access-key: YOUR_ACCESS_KEY