LocalLocationRankingHistoryFetch

Search API documentation

⌘K

Enterprise Only This method is available to only Enterprise Customers.

Returns keyword ranking position over time for a location's tracked keywords.

JSON-RPC Method:

local.location.ranking.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.

engine

string

The engine for the query.

Acceptable Values:

google

device

string

The device to perform the query for.

Acceptable Values:

desktopmobile

1{
2  "location_id": 12345,
3  "date_start": "2026-01-01",
4  "date_end": "2026-06-01",
5  "engine": "google",
6  "device": "desktop"
7}

Response

ranking_history

object

Keyword ranking history for a location over a date range. Echoes the requested location and range and carries the per-date reports (oldest to newest).

1{
2  "ranking_history": {
3    "location_id": 12345,
4    "date_start": "2026-01-01",
5    "date_end": "2026-06-01",
6    "engine": "google",
7    "device": "desktop",
8    "ranking_history_reports": [
9      {
10        "date": "2026-01-01",
11        "ranks": [
12          {
13            "keyword": "physical therapy near me",
14            "rank": 1
15          },
16          {
17            "keyword": "rehabilitation center in {%City}",
18            "rank": null
19          }
20        ]
21      }
22    ]
23  }
24}

Example Code

Quota Usage

Does not require any quota.