---
title: "List the search terms customers used to find the location"
method: GET
path: "/api/v1/misc/google-business/location/search-keywords"
tags: ["misc"]
---

# List the search terms customers used to find the location

`GET /api/v1/misc/google-business/location/search-keywords`

## Request

- Base URL: `https://api.bundle.social`
- URL: `https://api.bundle.social/api/v1/misc/google-business/location/search-keywords`
- Auth: API key in header `x-api-key`

Monthly search keyword impressions for your selected location. `startMonth`/`endMonth` are inclusive `YYYY-MM` values; counts are aggregated across the whole range, so request a single month for a per-month figure. Each keyword returns either an exact `value` or a `threshold`, meaning the real count is below that number: low-volume keywords are only ever reported as a threshold, so treat a null `value` as suppressed rather than zero. Counts are unique users, not raw impressions. Paginated with `pageToken`/`nextPageToken`, max `pageSize` 100.

## Query parameters

- `teamId` string, required
- `startMonth` string, required
- `endMonth` string, required
- `pageSize` integer
- `pageToken` string

## Response `200`

200

- object
  - `location` string, required: The Google Business location the keywords belong to, as `locations/{locationId}`.
  - `range` object, required
    - `startMonth` string, required: Month in `YYYY-MM` format, inclusive.
    - `endMonth` string, required: Month in `YYYY-MM` format, inclusive.
  - `searchKeywords` object[]
    - `searchKeyword` string, required: The lowercase query a customer typed to find the business.
    - `value` number, nullable: Exact number of unique users, when Google discloses it. Null when `threshold` is returned instead.
    - `threshold` number, nullable: Returned for low-volume keywords instead of `value`: the real count is below this number. Ignoring it drops the long tail.
  - `nextPageToken` string

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404
- `429`: 429
- `500`: 500
- `502`: 502
- `503`: 503
- `504`: 504

## Changes

- **2026-11-03** `fb6e4fbd8d2f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bundle/apis/bundle-social-api/changes/api/v1/misc/google-business/location/search-keywords/get.md)

---

[API](https://skmtc.dev/bundle/apis/bundle-social-api.md) - [All operations](https://skmtc.dev/bundle/apis/bundle-social-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bundle/apis/bundle-social-api/revisions/18efa1cb93a4?raw)