LocalLocationInsightGbpLeadHistoryFetch

Search API documentation

⌘K

Enterprise Only This method is available to only Enterprise Customers.

Returns Google Business Profile lead history over time for a given location, bucketed by day, week, or month. The date range may not exceed 12 months and buckets are returned ordered oldest to newest.

JSON-RPC Method:

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

date_aggregation

string

(Optional)

The bucket size used to aggregate a Google Business Profile insight time series. Accepted and returned in lowercase.

Acceptable Values:

dayweekmonth

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

Response

gbp_lead_history

object

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

1{
2  "gbp_lead_history": {
3    "location_id": 12345,
4    "date_start": "2025-01-01",
5    "date_end": "2025-12-31",
6    "date_aggregation": "month",
7    "gbp_lead_history_reports": [
8      {
9        "date": "2025-01-01",
10        "total_leads": 120,
11        "actions_website": 80,
12        "actions_phone": 25,
13        "actions_driving_directions": 15,
14        "total_impressions": 5400,
15        "ctr": 0.022
16      }
17    ]
18  }
19}

Example Code

Quota Usage

Does not require any quota.