Geo-Grid Rank Tracker & Local SEO Tool Reference
Detailed documentation for 7x7 Geo-Grid rank scans, Average Grid Rank (AGR), location silo builder, and schema generators.
Geo-Grid Rank Tracker & Local SEO Tool Reference — Official Video Tutorial
Watch this 3-minute video walkthrough to learn setup, parameters, and workflow best practices.
Overview
The SEO Toolkit provides 30+ specialized local SEO tools including the 7×7 Geo-Grid Rank Tracker, Content Silo Builder, Schema Generators, Citation Finders, and Keyword Tools.
7×7 Geo-Grid Rank Scans
The Geo-Grid Rank Tracker simulates mobile search requests across interactive coordinate grids (3×3, 5×5, 7×7) to measure local 3-pack rank positions. Each grid point represents a real GPS coordinate.
Average Grid Rank (AGR)
AGR is calculated as the mean rank position across all grid points. Lower AGR = better visibility. Track AGR trends over time to measure the impact of your local SEO campaigns.
Who Should Use This Tool
Requirements & Specifications
Required Input Fields
| Field Name | Purpose | Required | Example Value | Validation & Tips |
|---|---|---|---|---|
| Target Keyword | Local search query to track | Required | Emergency Plumber | 1-100 chars Use exact commercial intent keywords |
| Business Place ID / Name | Target GMB listing to monitor | Required | ChIJ7cv_u13w3YgR... | Valid Place ID or GBP title Use autocomplete to pick exact Place ID |
| Grid Size | Dimension of coordinate scan matrix | Required | 7x7 (49 points) | 3x3, 5x5, 7x7, 9x9 7x7 provides 49 GPS measurement points |
| Grid Radius / Distance | Spacing between coordinate nodes | Optional | 1.0 mile | 0.1 to 10.0 miles 1.0 mile spacing covers 7x7 mile metro area |
Output Data Schema
| Output Property | Data Type | Description | Sample Value |
|---|---|---|---|
| average_grid_rank | number | Mean rank position across all grid points (AGR) | 2.4 |
| top3_percentage | number | Percentage of grid points where business ranks in 3-pack | 84.2% |
| grid_points | array | Array of 49 coordinate objects with lat, lng, rank, and top 20 local results | [{lat: 27.95, lng: -82.45, rank: 1}] |
| heatmap_image_url | string | Rendered PNG heatmap image overlay URL | https://mapscrapx.com/maps/grid_99120.png |
End-to-End Workflow
Create Geo-Grid Job
Enter keyword 'Roof Repair', Place ID, and select 7x7 grid with 0.5 mile radius
Execute Mobile Search Stream
Headless workers simulate mobile browser requests at exact GPS coordinates
Calculate AGR & Heatmap
AGR computed (e.g. 2.1) and green/yellow/red color heatmap generated
Export Client PDF
1-Click 'Generate White-Label Rank Audit PDF'
Troubleshooting Guide
1 credit per coordinate point (49 credits for 7x7 grid)
Starter: 5,000 pts/mo | Professional: 25,000 pts/mo | Agency: 100,000 pts/mo
10 concurrent grid scans per workspace
Schedule weekly 7x7 scans for high-priority client keywords to track campaign progress.
REST API Reference
curl -X POST https://api.mapscrapx.com/v1/geogrid/scan \
-H "Authorization: Bearer ms_live_secret_key_88921" \
-H "Content-Type: application/json" \
-d '{"keyword": "Emergency Plumber", "place_id": "ChIJ7cv...", "grid_size": 7, "radius_miles": 1.0}'{
"scan_id": "grid_99120",
"status": "completed",
"average_grid_rank": 2.4,
"top3_percentage": 84.2,
"heatmap_url": "https://mapscrapx.com/maps/grid_99120.png"
}Frequently Asked Questions (15)
Click to expandA tool that simulates mobile Google searches at precise GPS coordinate points in a grid pattern to visualize local 3-pack rank positions.