{"uid":"cap_O2RhZ_CPtLkSex8imMtWA","slug":"agents-openwebninja-com-full-grid-search-local-rank-tracker-be32d78a","name":"Full Grid Search – Local Rank Tracker","description":"Make a full grid search and get the ranking of a specific business in every coordinate point in the grid.  \n  The grid cells / entires in the results are ordered left-to-right then top-down.","url":"https://agents.openwebninja.com/local-rank-tracker/grid?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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).."}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_uoklKKB1BwGQRDGF3yEoW","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Local SEO audit for a restaurant","prompt":"Do a full grid ranking check for my Italian restaurant (Place ID ChIJrTLr-GyuEmsRBfy61i59si0) using the keyword 'Italian restaurant', centered at 40.7128, -74.0060, with a 5x5 square grid and 0.5 mile spacing between points."},{"title":"Competitor visibility analysis across a city","prompt":"I want to see how a competitor gym (Place ID ChIJd8BlQ2BZwokRAFUEcm_qrcA) ranks for 'gym near me' across a 9x9 grid centered at 34.0522, -118.2437 with 1 km radius — give me their average rank and the percentage of spots where they hit the top 3."},{"title":"Track ranking changes after Google Business update","prompt":"Can you run a round-shaped 5x5 grid search for my dental clinic (Place ID ChIJp4JiUCNP0xQR1JaSjpW_Hzk) searching 'dentist', centered at 51.5074, -0.1278, with 0.3 km between grid points, so I can see how visible we are across our local area?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:51.525Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-full-grid-search-local-rank-tracker-be32d78a"}