GETapi.synup.com/api/v4/grid-report/{reportId}
Fetch Rank Grid Report By ID
This API retrieves all grid rank reports associated with a specific location.
Behaviour:
- Business details – It returns a list of reports generated for the given location.
- Grid configuration – Grid size, geographic coordinates, and search parameters.
- Ranking results – Performance across specified keywords within the grid.
Requires an API key. Send it as
Authorization: API <your-key> — see Getting started.Parameters
Path
| Name | Type | Required | Description |
|---|---|---|---|
reportId | string | required | UUID of the report to fetch |
Request
Request
curl -X GET 'https://api.synup.com/api/v4/grid-report/:reportId' \
-H 'Authorization: API YOUR_API_KEY' \
-H 'Content-Type: application/json'const res = await fetch('https://api.synup.com/api/v4/grid-report/:reportId', {
method: 'GET',
headers: {
Authorization: 'API YOUR_API_KEY',
'Content-Type': 'application/json',
},
});
const data = await res.json();import requests
res = requests.get(
"https://api.synup.com/api/v4/grid-report/:reportId",
headers={
"Authorization": "API YOUR_API_KEY",
"Content-Type": "application/json",
},
)
data = res.json()req, _ := http.NewRequest("GET", "https://api.synup.com/api/v4/grid-report/:reportId", nil)
req.Header.Set("Authorization", "API YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)Responses
| Status | Description |
|---|---|
200 | Grid rank report retrieved successfully |
400 | Bad Request - Invalid report ID format |
401 | Unauthorized - Valid API key required |
403 | Forbidden - Insufficient permissions |
404 | Report not found |
Example response
{
"data": {
"gridrankReportById": {
"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"
}
}
}Response body
| Name | Type | Required | Description |
|---|---|---|---|
data | object | optional | |
data.gridrankReportById | object | optional | |
data.gridrankReportById.id | string | optional | Report ID |
data.gridrankReportById.locationId | string | optional | Location ID |
data.gridrankReportById.accountId | string | optional | Account ID |
data.gridrankReportById.keyword | string | optional | Keyword used for rank analysis |
data.gridrankReportById.businessName | string | optional | Exact name of the business in Google Maps |
data.gridrankReportById.businessStreet | string | optional | Street address of the business |
data.gridrankReportById.businessCity | string | optional | City of the business |
data.gridrankReportById.businessState | string | optional | State of the business |
data.gridrankReportById.businessCountry | string | optional | Country of the business |
data.gridrankReportById.gridSize | integer | optional | Size of the grid used for analysis357 |
data.gridrankReportById.gridDistance | number | optional | Grid distance value |
data.gridrankReportById.gridDistanceUnit | string | optional | Unit of grid distance measurementmikm |
data.gridrankReportById.gridDistanceInKm | number | optional | Grid distance converted to kilometers |
data.gridrankReportById.ranks | array of object | optional | Array of ranking results for each coordinate |
data.gridrankReportById.ranks[].rank | number | optional | Rank at this coordinate (-1 if not ranked) |
data.gridrankReportById.ranks[].latitude | number | optional | Latitude of the grid point |
data.gridrankReportById.ranks[].longitude | number | optional | Longitude of the grid point |
data.gridrankReportById.averageRank | number | optional | Average rank across all grid points |
data.gridrankReportById.topOneShare | number | optional | Percentage of coordinates with rank <= 3 |
data.gridrankReportById.topTwoShare | number | optional | Percentage of coordinates with rank <= 10 |
data.gridrankReportById.status | string | optional | Current status of the reportPROCESSINGCOMPLETED |
data.gridrankReportById.latitude | number | optional | Business latitude coordinate |
data.gridrankReportById.longitude | number | optional | Business longitude coordinate |
data.gridrankReportById.placeId | string | optional | Google Place ID of the business |
data.gridrankReportById.createdAt | string | optional | Epoch timestamp in milliseconds |