Documentation

Sans code : n8n, Make, Zapier, RapidAPI

Des cartes GeoGridAPI sans écrire une ligne de code : le nœud n8n officiel, le module HTTP de Make et Zapier, ou la fiche RapidAPI.

Le nœud n8n en 4 étapes

« GeoGridAPI », le nœud officiel publié sur npm (n8n-nodes-geogridapi). Vos crédits paient les cartes, comme avec l’API.

  1. Installez le nœud

    n8n auto-hébergé : Settings, Community Nodes, Install, puis n8n-nodes-geogridapi.

  2. Ajoutez votre clé

    Identifiant GeoGridAPI API, avec une clé gga_live_ de la console. Une clé gga_test_ donne des cartes d’exemple gratuites pour monter le workflow.

  3. Lancez une carte

    Nœud GeoGridAPI, Grid puis Run : la fiche (nom et ville, ou place ID), le mot-clé et le format. Wait for Completion rend le résultat, de 20 secondes à 2 minutes plus tard.

  4. Envoyez le résultat

    Dans Google Sheets, Slack ou un e-mail. Grid puis Get Image donne la heatmap PNG, prête pour un rapport client.

  • Grilles

    Lancer et attendre
    Grid → Run
    Prix exact
    Grid → Estimate
    Heatmap PNG
    Grid → Get Image
    Évolution
    Grid → Get History

  • Fiches et lots

    Trouver une fiche
    Listing → Search
    Jusqu’à 50 cartes
    Batch → Run
    Suivre un lot
    Batch → Get

  • Suivi et compte

    Chaque semaine ou mois
    Schedule → Create
    Pause ou reprise
    Schedule → Update
    Solde de crédits
    Account → Get Balance

Chaque carte donne

  • le rang à chaque point
  • le rang moyen
  • les points dans le top 3
  • les concurrents devant
  • l’écart avec la carte précédente
Voir le nœud sur npmCode source sur GitHub

Chaque semaine, dans un tableur

  1. Planifiez

    Un nœud Schedule Trigger, par exemple chaque lundi à 8 h.

  2. Mesurez

    GeoGridAPI, Grid puis Run, avec Wait for Completion. Un nœud par fiche et mot-clé, ou Batch puis Run pour en lancer jusqu’à 50.

  3. Notez

    Google Sheets, Append Row : summary.average_rank, summary.top3_points et previous.changes.average_rank (négatif = mieux).

Make, Zapier et les autres : le module HTTP

Votre outil appelle l’API avec votre clé GeoGridAPI, et vos crédits paient les cartes.

  1. Envoyez la carte à mesurer

    Méthode POST, ces en-têtes et ce corps JSON. La réponse arrive tout de suite avec l’id de la carte, statut pending.

    Requête
    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. Recevez le résultat

    Mettez dans webhook_url l’adresse d’un webhook de votre outil : la carte terminée y arrive. Sans webhook, lisez-la avec son id, de 20 secondes à 2 minutes plus tard.

    Lire la carte
    GET https://api.geogridapi.io/v1/grids/3f2c…
Authorization: Bearer gga_live_…

  • Make

    Envoyer
    HTTP, Make a request
    Recevoir
    Webhooks, Custom webhook

  • Zapier

    Envoyer
    Webhooks by Zapier, POST
    Recevoir
    Webhooks by Zapier, Catch Hook

  • Autres outils

    Envoyer
    Requête HTTP POST
    Recevoir
    Webhook entrant

    Pipedream, Activepieces, Power Automate… Les champs de chaque appel sont décrits dans openapi.json.

Tous les champs de la requêteSpécification OpenAPI

Sur RapidAPI

Déjà client de RapidAPI ? « Google Maps Geo-Grid Rank Tracker » y est publié par GeoGridAPI : un abonnement mensuel RapidAPI, votre clé RapidAPI, les mêmes cartes.

Forfaits RapidAPI, par mois
ForfaitPointsPrix
Basic100Gratuit
Pro10 00025 $
Ultra50 00075 $
Mega150 000150 $

Facturation RapidAPI

1 point de la carte = 1 Point

Une carte 7 × 7 compte 49 Points, au moment où elle est créée. Au-delà du forfait : 0,003 $ le point en Pro, 0,002 $ en Ultra, 0,0015 $ en Mega.

Gratuits : recherche de fiche, estimation, lecture des cartes, image et évolution. Les lots et les cartes répétées passent par une clé GeoGridAPI.

Ouvrir la fiche RapidAPI

Avec Apify

L’Actor « Google Maps Geo-Grid Rank Tracker », publié sur Apify par GeoGridAPI, pour ceux qui travaillent déjà sur Apify. Il vous faut un compte Apify.

  1. Ouvrez l’Actor

    Sur Apify, connecté à votre compte.

  2. Ajoutez fiches et mots-clés

    Une fiche par ligne : nom et ville, ou place_id. Un mot-clé par ligne, tel que vos clients le tapent.

  3. Choisissez la carte

    Carré de 3 × 3 à 9 × 9, ou cercle, losange, hexagone, croix, ellipse, rectangle jusqu’à 49 points. Puis le rayon, la langue, le pays et, si vous le voulez, l’image PNG.

  4. Cliquez sur Start

    Une ligne par fiche × mot-clé, jusqu’à 100 cartes par run. Planifiez-le dans Schedules, exportez en CSV, Excel ou JSON.

Ouvrir l’Actor sur Apify

Apify : deux façons de payer

Sans clé

Apify facture

0,005 $ par point mesuré, plateforme Apify incluse. Remise à partir du forfait Scale d’Apify : 0,0045 $ avec Scale, 0,004 $ avec Business et au-delà.

Prix d’une carte sur Apify, sans clé (forfaits Free et Starter)
CartePointsPrix
3 × 390,045 $
5 × 5250,125 $
7 × 7490,245 $
9 × 9810,405 $

Avec votre clé GeoGridAPI

Vos crédits paient

Collez votre clé dans le champ « Your GeoGridAPI key » : les cartes utilisent vos crédits GeoGridAPI et Apify ne facture aucun point, seulement 0,00005 $ au démarrage du run.

Une clé gga_test_ donne des cartes d’exemple gratuites.

Créer un compte et une clé · 500 crédits offerts