LocalLocationInsightGbpImpressionTotalFetch

Search API documentation

⌘K

Enterprise Only This method is available to only Enterprise Customers.

Returns total Google Business Profile keyword impressions for a given location and date range, ordered from most to least impressions. The date range may not exceed 12 months.

JSON-RPC Method:

local.location.insight.gbp.impression.total.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.

page

object

Control the number of results returned per call in addition to fetching additional results. The default limit is 25 with an n value of 0 (indicating the first page of results). Make subsequent calls to the endpoint with incrementing n values to fetch additional pages of results. To get all results, you must continue making calls with incrementing n values until an empty result set is returned.

Response

gbp_impression_total

object

Total Google Business Profile keyword impressions for a location over a date range. Echoes back the requested location and date range and carries the per-keyword totals ordered from most to least impressions.

page

object

Control how much data is returned by providing a specific page number (n) and limit to the number of results in a given page.

1{
2  "gbp_impression_total": {
3    "location_id": 12345,
4    "date_start": "2025-01-01",
5    "date_end": "2025-12-31",
6    "gbp_impression_keyword_totals": [
7      {
8        "keyword": "tutoring near me",
9        "value": 792
10      },
11      {
12        "keyword": "tutoring",
13        "value": null
14      }
15    ]
16  },
17  "page": {
18    "n": 0,
19    "limit": 25
20  }
21}

Example Code

Quota Usage

Does not require any quota.