{"uid":"cap_3a0ox8hvAe68cHxlA8kYm","slug":"french-address-geocoding-via-base-adresse-nationale-d02dbd07","name":"French Address Geocoding via Base Adresse Nationale","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://x402-datashop-production.up.railway.app/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":null,"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_vZIJzzhNvIvAwn5VipqHy","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":"Forward and reverse geocoding of French addresses using the official Base Adresse Nationale (BAN) dataset from Etalab/IGN","exampleAgentPrompt":"Can you geocode the French address '8 boulevard du Port, Amiens' and give me only housenumber-level matches — limit 3 results and include the INSEE city code and confidence scores?","exampleUseCases":null,"resultDescription":"A list of up to 10 matched address features, each with a normalized label, confidence score (0–1), latitude/longitude, street name, postcode, city name, INSEE citycode, and administrative context. Returns a 400 if no match is found (and no charge is incurred). Results are cached for 24 hours.","failureModes":["No match found for the given address — returns 400 (not billed)","Invalid or missing query parameters (no q for forward, or lat/lon mismatch for reverse)","INSEE citycode filter too restrictive — no results in that commune","Address text too ambiguous — low-confidence or unexpected matches returned","Reverse geocode outside France — may return no results or irrelevant matches"],"whenToPreferThis":"Use this endpoint when you need authoritative, continuously-updated French address geocoding backed by the official BAN dataset. Prefer this over generic geocoders (Google Maps, HERE, Nominatim) when you need INSEE city codes, official French address normalization, or reliable coverage of rural and urban French addresses. The per-call pricing ($0.001 USDC) and 24h caching make it cost-effective for bulk lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:53:18.943Z","isFirstParty":false}