Fetch All Grid Reports for Location

This API generates a new rank grid report to analyze business rankings for specified keywords across a grid specified by the user using grid distance and the number of grid coordinates to be analyzed.
Behavior:

Returns a list of reports generated for the given location.

Includes report IDs, keywords analyzed, and timestamps.

Can be used to track ranking trends over time.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Grid rank reports retrieved successfully

Body

Example

{
    "data": {
        "gridrankReportsByLocationId": [
            {
                "id": "df996f3d-1c0e-48da-be74-8cfec452984b",
                "locationId": "84703",
                "accountId": "15004",
                "keyword": "italian restaurant",
                "businessName": "Chianti, Koramangala",
                "businessStreet": "No 12, 5th Block, Koramangala",
                "businessCity": "Bengaluru",
                "businessState": "Karnataka",
                "businessCountry": "India",
                "gridSize": 3,
                "gridDistance": 20,
                "gridDistanceUnit": "km",
                "gridDistanceInKm": 20,
                "ranks": [
                    {
                        "rank": 6,
                        "latitude": 12.80803271879746,
                        "longitude": 77.4894662571528
                    }
                ],
                "averageRank": 8.25,
                "topOneShare": 0,
                "topTwoShare": 0,
                "status": "COMPLETED",
                "latitude": 12.935216,
                "longitude": 77.619961,
                "placeId": null,
                "createdAt": "1719372126514"
            }
        ]
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found