LocalLocationLocalGridHistoryFetch

Search API documentation

⌘K

Enterprise Only This method is available to only Enterprise Customers.

Returns all Local Grid results over time for a given keyword, device, engine, and location, including every dot of each grid. Grids are returned ordered oldest to newest by their search date.

JSON-RPC Method:

local.location.local.grid.history.fetch

Go to Example Code

Request

location_id

number

The id of the location

keyword

string

The Local Grid keyword the grid ranks are for.

device

string

The device to perform the query for.

Acceptable Values:

desktopmobile

engine

string

The engine for the query.

Acceptable Values:

google

date_start

string

A calendar date in YYYY-MM-DD format.

date_end

string

A calendar date in YYYY-MM-DD format.

1{
2  "location_id": 12345,
3  "keyword": "tutoring",
4  "device": "mobile",
5  "engine": "google",
6  "date_start": "2026-01-01",
7  "date_end": "2026-04-01"
8}

Response

local_grid_history

object

Local Grid history for a location, keyword, engine, and device over a date range. Echoes back the requested location, range, keyword, device, and engine and carries the per-search-date grids.

1{
2  "local_grid_history": {
3    "location_id": 12345,
4    "date_start": "2026-01-01",
5    "date_end": "2026-04-01",
6    "keyword": "tutoring",
7    "device": "mobile",
8    "engine": "google",
9    "grids": [
10      {
11        "grid_size": 3,
12        "grid_distance": 1,
13        "grid_distance_unit": "miles",
14        "formatted_grid_distance": "1 miles",
15        "date": "2026-02-12",
16        "dots": [
17          {
18            "row": -1,
19            "column": -1,
20            "lat": 40.01,
21            "long": -74.01,
22            "rank": 1,
23            "rating": 4.8,
24            "votes_count": 25
25          },
26          {
27            "row": -1,
28            "column": 0,
29            "lat": 40.01,
30            "long": -74,
31            "rank": 1,
32            "rating": 4.8,
33            "votes_count": 25
34          },
35          {
36            "row": -1,
37            "column": 1,
38            "lat": 40.01,
39            "long": -73.99,
40            "rank": 2,
41            "rating": 4.8,
42            "votes_count": 25
43          },
44          {
45            "row": 0,
46            "column": -1,
47            "lat": 40,
48            "long": -74.01,
49            "rank": 1,
50            "rating": 4.8,
51            "votes_count": 25
52          },
53          {
54            "row": 0,
55            "column": 0,
56            "lat": 40,
57            "long": -74,
58            "rank": 1,
59            "rating": 4.8,
60            "votes_count": 25
61          },
62          {
63            "row": 0,
64            "column": 1,
65            "lat": 40,
66            "long": -73.99,
67            "rank": 1,
68            "rating": 4.8,
69            "votes_count": 25
70          },
71          {
72            "row": 1,
73            "column": -1,
74            "lat": 39.99,
75            "long": -74.01,
76            "rank": 2,
77            "rating": 4.8,
78            "votes_count": 25
79          },
80          {
81            "row": 1,
82            "column": 0,
83            "lat": 39.99,
84            "long": -74,
85            "rank": 1,
86            "rating": 4.8,
87            "votes_count": 25
88          },
89          {
90            "row": 1,
91            "column": 1,
92            "lat": 39.99,
93            "long": -73.99,
94            "rank": 1,
95            "rating": 4.8,
96            "votes_count": 25
97          }
98        ]
99      }
100    ]
101  }
102}

Example Code

Quota Usage

Does not require any quota.