# Full Grid Search – Local Rank Tracker

> Full Grid Search – Local Rank Tracker is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Performs a multi-point geospatial grid search on Google Maps and returns the ranking position of a specific business at every coordinate point in the grid.

## Facts

- Endpoint: GET https://agents.openwebninja.com/local-rank-tracker/grid?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-full-grid-search-local-rank-tracker-be32d78a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O2RhZ_CPtLkSex8imMtWA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-full-grid-search-local-rank-tracker-be32d78a
```

Example prompt: Run a full 7x7 grid search centered on 37.3418, -121.9383 for the keyword 'coffee shop', using a 0.5 km radius between points, and tell me how my business (Google Place ID ChIJN1t_tDeuEmsRUsoyG83frY3) ranks across the entire grid.

## When to prefer this

Choose this endpoint when you need a comprehensive spatial view of a business's Google Maps ranking across an entire area, not just a single point. It is the right choice for local SEO audits, competitive analysis, and geographic visibility mapping where you want to know how ranking varies block-by-block or kilometer-by-kilometer across a city or neighborhood. Use the single-point 'Ranking at Coordinate Point' endpoint instead when you only need the rank at one specific location.

## Known failure modes

- Invalid or non-existent Google Place ID returns no match data
- Search query returns no results for a given coordinate, reducing 'found' count
- Out-of-range radius (below 0.1 or above 100) causes validation error
- Invalid grid_size (not in allowed enum) returns parameter error
- API payment or authentication failure returns 402 or 401 status
- Network timeout for large grids (e.g., 15x15) with many coordinate lookups
- Coordinates outside any populated area return low or zero found-percent

## How this service works

Make a full grid search and get the ranking of a specific business in every coordinate point in the grid.  
  The grid cells / entires in the results are ordered left-to-right then top-down.

## Output

Returns a summary object with: total grid points analyzed, number of points where the business was found, average rank at found points, overall average rank across all points, percentage of points where the business was found, and percentage of points where the business ranked in the top 3. Also echoes back the input parameters and provides a unique request ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "place_id",
  "query",
  "lat",
  "lng",
  "grid_size",
  "radius"
 ],
 "properties": {
  "lat": {
   "type": "number",
   "default": 37.341759,
   "description": "Grid center coordinate point latitude value."
  },
  "lng": {
   "type": "number",
   "default": -121.938314,
   "description": "Grid center coordinate point longitude value."
  },
  "zoom": {
   "type": "number",
   "default": 13,
   "description": "Google Maps zoom level to use for search on each grid point.  \n\n  **Allowed values:** `0-18`"
  },
  "query": {
   "type": "string",
   "description": "Search query / keyword."
  },
  "shape": {
   "enum": [
    "square",
    "round"
   ],
   "type": "string",
   "default": "square",
   "description": "The shape of the grid (square or round)."
  },
  "radius": {
   "type": "number",
   "default": 1,
   "description": "The distance between coordinate points (on the same row / column in the grid).  \n  The units of the radius are determined by the distance_units parameter.  \n  \n  **Allowed values:** `0.1-100`  "
  },
  "place_id": {
   "type": "string",
   "description": "The Google Place ID of the business to match against in results."
  },
  "grid_size": {
   "enum": [
    3,
    5,
    7,
    9,
    11,
    13,
    15
   ],
   "type": "number",
   "default": 3,
   "description": "The size of the grid *(i.e. 3x3, 5x5, 7x7, etc)*."
  },
  "radius_units": {
   "enum": [
    "km",
    "mi"
   ],
   "type": "string",
   "default": "km",
   "description": "Distance measurement units to use for the radius parameter (kilometers / miles).."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "found": {
     "type": "integer",
     "description": "The number of locations found in the search"
    },
    "points": {
     "type": "integer",
     "description": "The total number of points analyzed in the search"
    },
    "average_rank": {
     "type": "number",
     "description": "The average rank of found locations"
    },
    "found_percent": {
     "type": "integer",
     "description": "The percentage of locations found relative to points analyzed"
    },
    "average_total_rank": {
     "type": "number",
     "description": "The overall average rank of all analyzed locations"
    },
    "top_3_rank_percent": {
     "type": "integer",
     "description": "The percentage of locations ranked in the top 3"
    }
   }
  },
  "status": {
   "type": "string",
   "description": "The status of the response"
  },
  "parameters": {
   "type": "object",
   "properties": {
    "lat": {
     "type": "string",
     "description": "The latitude coordinate of the search location"
    },
    "lng": {
     "type": "string",
     "description": "The longitude coordinate of the search location"
    },
    "zoom": {
     "type": "string",
     "description": "The zoom level of the search area"
    },
    "query": {
     "type": "string",
     "description": "The search query used in the request"
    },
    "radius": {
     "type": "string",
     "description": "The radius of the search area"
    },
    "place_id": {
     "type": "string",
     "description": "The unique identifier for the place"
    },
    "grid_size": {
     "type": "string",
     "description": "The size of the grid used in the search"
    },
    "radius_units": {
     "type": "string",
     "description": "The units of measurement for the radius"
    }
   }
  },
  "request_id": {
   "type": "string",
   "description": "A unique identifier for the request"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-full-grid-search-local-rank-tracker-be32d78a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)