LocalLocationInsightGbpImpressionHistoryFetch

Search API documentation

⌘K

Enterprise Only This method is available to only Enterprise Customers.

Returns Google Business Profile keyword-impression history over time (month by month) for a location's top-performing keywords. Buckets are returned ordered oldest to newest.

JSON-RPC Method:

local.location.insight.gbp.impression.history.fetch

Go to Example Code

Request

location_id

number

The id of the location

date_start

string

A calendar date in YYYY-MM-DD format.

date_end

string

A calendar date in YYYY-MM-DD format.

keyword_limit

number

(Optional)

Max number of top keywords returned per Google Business Profile impression bucket.

1{
2  "location_id": 12345,
3  "date_start": "2025-01-01",
4  "date_end": "2025-12-31",
5  "keyword_limit": 50
6}

Response

gbp_impression_history

object

Google Business Profile keyword-impression history for a location over a date range. Echoes back the requested location, range, and keyword limit and carries the per-bucket reports.

1{
2  "gbp_impression_history": {
3    "location_id": 12345,
4    "date_start": "2025-01-01",
5    "date_end": "2025-12-31",
6    "keyword_limit": 50,
7    "gbp_impression_history_reports": [
8      {
9        "date": "2025-01-01",
10        "impressions": [
11          {
12            "keyword": "tutoring",
13            "value": 291
14          },
15          {
16            "keyword": "online tutoring",
17            "value": 55
18          }
19        ]
20      }
21    ]
22  }
23}

Example Code

Quota Usage

Does not require any quota.