Documentation

No code: n8n, Make, Zapier, RapidAPI

GeoGridAPI maps without writing a line of code: the official n8n node, the HTTP module of Make and Zapier, or the RapidAPI listing.

The n8n node in 4 steps

“GeoGridAPI”, the official node published on npm (n8n-nodes-geogridapi). Your credits pay for the maps, as with the API.

  1. Install the node

    Self-hosted n8n: Settings, Community Nodes, Install, then n8n-nodes-geogridapi.

  2. Add your key

    GeoGridAPI API credential, with a gga_live_ key from the console. A gga_test_ key returns free sample maps to build the workflow.

  3. Run a map

    GeoGridAPI node, Grid then Run: the listing (name and city, or place ID), the keyword and the format. Wait for Completion returns the result 20 seconds to 2 minutes later.

  4. Send the result

    To Google Sheets, Slack or an email. Grid then Get Image returns the PNG heatmap, ready for a client report.

  • Grids

    Run and wait
    Grid → Run
    Exact price
    Grid → Estimate
    PNG heatmap
    Grid → Get Image
    Trend
    Grid → Get History

  • Listings and batches

    Find a listing
    Listing → Search
    Up to 50 maps
    Batch → Run
    Track a batch
    Batch → Get

  • Tracking and account

    Every week or month
    Schedule → Create
    Pause or resume
    Schedule → Update
    Credits balance
    Account → Get Balance

Each map gives

  • the rank at each point
  • the average rank
  • the points in the top 3
  • the competitors ahead
  • the change since the previous map
See the node on npmSource code on GitHub

Every week, in a spreadsheet

  1. Schedule

    A Schedule Trigger node, every Monday at 8 am for example.

  2. Measure

    GeoGridAPI, Grid then Run, with Wait for Completion. One node per listing and keyword, or Batch then Run for up to 50.

  3. Log

    Google Sheets, Append Row: summary.average_rank, summary.top3_points and previous.changes.average_rank (negative is better).

Make, Zapier and others: the HTTP module

Your tool calls the API with your GeoGridAPI key, and your credits pay for the maps.

  1. Send the map to measure

    POST method, these headers and this JSON body. The answer comes right away with the map id, status pending.

    Request
    POST https://api.geogridapi.io/v1/grids
Authorization: Bearer gga_live_…
Content-Type: application/json

{
  "query": "Plomberie Vauban, Lille",
  "keyword": "plombier",
  "size": 7,
  "radius_km": 3,
  "webhook_url": "https://example.com/webhooks/geogridapi"
}

  2. Get the result

    Put the address of a webhook from your tool in webhook_url: the finished map lands there. Without a webhook, read it by its id, 20 seconds to 2 minutes later.

    Read the map
    GET https://api.geogridapi.io/v1/grids/3f2c…
Authorization: Bearer gga_live_…

  • Make

    Send
    HTTP, Make a request
    Receive
    Webhooks, Custom webhook

  • Zapier

    Send
    Webhooks by Zapier, POST
    Receive
    Webhooks by Zapier, Catch Hook

  • Other tools

    Send
    HTTP POST request
    Receive
    Incoming webhook

    Pipedream, Activepieces, Power Automate… Every call’s fields are described in openapi.json.

Every request fieldOpenAPI specification

On RapidAPI

Already on RapidAPI? “Google Maps Geo-Grid Rank Tracker” is published there by GeoGridAPI: a monthly RapidAPI subscription, your RapidAPI key, the same maps.

RapidAPI plans, per month
PlanPointsPrice
Basic100Free
Pro10,000$25
Ultra50,000$75
Mega150,000$150

RapidAPI billing

1 map point = 1 Point

A 7 × 7 map counts 49 Points, when it is created. Beyond the plan: $0.003 per point on Pro, $0.002 on Ultra, $0.0015 on Mega.

Free: listing search, estimate, reading maps, image and trend. Batches and repeated maps need a GeoGridAPI key.

Open the RapidAPI listing

With Apify

The “Google Maps Geo-Grid Rank Tracker” Actor, published on Apify by GeoGridAPI, for those who already work on Apify. You need an Apify account.

  1. Open the Actor

    On Apify, logged in to your account.

  2. Add listings and keywords

    One listing per line: name and city, or place_id. One keyword per line, as your customers type it.

  3. Pick the map

    A 3 × 3 to 9 × 9 square, or a circle, diamond, hexagon, cross, ellipse or rectangle up to 49 points. Then the radius, the language, the country and, if you want, the PNG image.

  4. Click Start

    One row per listing × keyword, up to 100 maps per run. Schedule it in Schedules, export to CSV, Excel or JSON.

Open the Actor on Apify

Apify: two ways to pay

Without a key

Apify charges

$0.005 per point measured, Apify platform included. Discount from Apify’s Scale plan: $0.0045 on Scale, $0.004 on Business and up.

Price of a map on Apify, without a key (Free and Starter plans)
MapPointsPrice
3 × 39$0.045
5 × 525$0.125
7 × 749$0.245
9 × 981$0.405

With your GeoGridAPI key

Your credits pay

Paste your key in the “Your GeoGridAPI key” field: the maps use your GeoGridAPI credits and Apify charges no points, only $0.00005 when the run starts.

A gga_test_ key returns free sample maps.

Create an account and a key · 500 free credits