---
title: "Get Google Business Profile search keywords"
method: GET
path: "/v1/analytics/googlebusiness/search-keywords"
tags: ["Analytics"]
---

# Get Google Business Profile search keywords

`GET /v1/analytics/googlebusiness/search-keywords`

Returns search keywords that triggered impressions for a Google Business Profile location.
Data is aggregated monthly. Keywords below a minimum impression threshold set by Google are excluded.
Max 18 months of historical data. Requires the Analytics add-on.

## Query parameters

- `accountId` string, required
- `startMonth` string
- `endMonth` string

## Response `200`

Search keywords with impression counts

- object
  - `success` boolean
  - `accountId` string
  - `platform` string
  - `monthRange` object
    - `startMonth` string
    - `endMonth` string
  - `keywords` object[]
    - `keyword` string
    - `impressions` integer
  - `note` string

## Other responses

- `400` — Invalid parameters
- `401` — Unauthorized
- `402` — Analytics access required. Legacy plans need the Analytics add-on; included by default on usage-based plans.
- `403` — Access denied
- `502` — The platform returned a server error.
- `503` — An upstream service or database is temporarily unavailable. Retry after the indicated delay. A timed-out write may have completed upstream; check its outcome before resubmitting.

## Changes

- **2026-09-16** `3e6ddf2a99ea` — 2 info
  - added the optional property `details/budgetScope` to the response with the `502` status
  - added the optional property `details/budgetScope` to the response with the `503` status
- **2026-09-15** `0dba7d004d75` — 4 info
  - added the optional property `details/quotaExhausted` to the response with the `502` status
  - added the optional property `details/quotaExhausted` to the response with the `503` status
  - added the optional property `details/quotaScope` to the response with the `502` status
  - added the optional property `details/quotaScope` to the response with the `503` status
- **2026-09-10** `e70ed06e7150` — 2 info
  - added the non-success response with the status `502`
  - added the non-success response with the status `503`

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/analytics/googlebusiness/search-keywords/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/fdaf9a9fb1a7?raw)