{"uid":"cap_NCGpVVthiT6gcLiEKN6IA","slug":"greeneris-french-address-geocoder-fd76bd0b","name":"Greeneris French Address Geocoder","description":"French address geocoding on the official Base Adresse Nationale (api-adresse.data.gouv.fr, Etalab/IGN, continuously updated). Forward: ?q=8 boulevard du port amiens with optional &type=housenumber|street|locality|municipality &citycode=80021 (INSEE filter). Reverse: ?lat=49.897&lon=2.290. &limit=1-10 (default 3). Each match returns normalized label, confidence score, lat/lon, street, postcode, city, INSEE citycode and context. No match returns 400 (not billed). Cached 24h.","url":"https://data.greeneris.io/v1/fr/geocode","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"q":{"type":"string","description":"Free-text French address (forward mode)"},"lat":{"type":"number","description":"Latitude (reverse mode, with lon)"},"lon":{"type":"number","description":"Longitude (reverse mode, with lat)"},"type":{"enum":["housenumber","street","locality","municipality"],"type":"string","description":"Restrict match type"},"limit":{"type":"integer","description":"Max matches, 1-10 (default 3)"},"citycode":{"type":"string","description":"Filter by 5-char INSEE city code"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"mode":"search","count":1,"query":"8 boulevard du port amiens","source":"Base Adresse Nationale via api-adresse.data.gouv.fr (Etalab/IGN, Licence Ouverte 2.0)","matches":[{"lat":49.897442,"lon":2.290084,"city":"Amiens","type":"housenumber","label":"8 Boulevard du Port 80000 Amiens","score":0.97072,"street":"Boulevard du Port","context":"80, Somme, Hauts-de-France","citycode":"80021","postcode":"80000","housenumber":"8"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RykYe3qbJRcPC0aNekPnU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Geocodes or reverse-geocodes French addresses using the official Base Adresse Nationale (BAN) registry","exampleAgentPrompt":"Can you geocode the French address '8 boulevard du Port, 80000 Amiens' and give me its exact coordinates and official INSEE city code?","exampleUseCases":null,"resultDescription":"A JSON object with mode, query, source attribution, and a matches array. Each match includes latitude, longitude, formatted label, street name, city, postcode, INSEE citycode, Département context, match type (housenumber/street/locality/municipality), and a confidence score (0–1).","failureModes":["No match found: matches array is empty with count 0 if the address is outside France or too ambiguous","Invalid coordinates for reverse mode: missing lat or lon returns a 400-level error","Limit out of range: values outside 1–10 may be rejected or clamped","Payment required: HTTP 402 with a machine-readable USDC quote if x402 payment header is absent","Rate or quota issues if the underlying BAN API is temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need authoritative, official French address geocoding backed by the national BAN registry (INSEE/IGN). Prefer it over generic geocoders when you need INSEE city codes, official French address labels, or high-confidence normalization of French addresses for compliance or business verification workflows. It is pay-per-call with no account setup required, making it ideal for AI agents with sporadic or one-off geocoding needs within France.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:58:17.852Z","isFirstParty":false}