{"uid":"cap_fCKiryaRJrUKtYUC1lRmn","slug":"french-communes-lookup-geo-api-gouv-fr-6d3bd926","name":"French Communes Lookup (geo.api.gouv.fr)","description":"Official French administrative reference from geo.api.gouv.fr (INSEE/IGN data). Look up communes by ?cp=31700 (postal code), ?code=31056 (INSEE), ?nom=Blagnac (fuzzy name) or ?lat=43.63&lon=1.37 (commune containing a point). Returns up to 20 communes with name, INSEE code, population, postal codes, departement, region and EPCI. The postal-to-INSEE mapping is the pivot key for joining French territorial datasets. Cached 7 days.","url":"https://x402-datashop-production.up.railway.app/v1/fr/communes","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":{"cp":{"type":"string","description":"5-digit postal code, e.g. 31700"},"lat":{"type":"number","description":"Latitude (with lon: commune containing the point)"},"lon":{"type":"number","description":"Longitude (with lat)"},"nom":{"type":"string","description":"Commune name, fuzzy search"},"code":{"type":"string","description":"5-character INSEE commune code, e.g. 31056"}}}},"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_yCGl7vs8i_qR_JH1T8GuD","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":"Look up French communes by postal code, INSEE code, fuzzy name, or geographic coordinates, returning name, INSEE code, population, postal codes, département, région, and EPCI.","exampleAgentPrompt":"What is the INSEE code, population, and région for the commune with postal code 31700 in France?","exampleUseCases":null,"resultDescription":"Returns up to 20 matching communes, each with name, INSEE code, population, list of postal codes, département code and name, région code and name, and EPCI identifier. Response is cached for 7 days.","failureModes":["No commune found matching the provided postal code, INSEE code, name, or coordinates — returns empty results array","Invalid or malformed query parameter (e.g. non-numeric lat/lon) — may return 400 or empty results","Point coordinates that fall outside France or in the sea return no matching commune","Fuzzy name search with very ambiguous input may return unexpected communes","Upstream geo.api.gouv.fr unavailability causes proxy errors"],"whenToPreferThis":"Use this endpoint when you need authoritative French commune reference data including the postal-to-INSEE code mapping, which is the canonical join key for French territorial datasets. Prefer this over general geocoding APIs when you specifically need INSEE codes, EPCI identifiers, or French administrative hierarchy (département/région). Ideal for enriching addresses, validating French postal codes, or joining INSEE demographic datasets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:20.025Z","isFirstParty":false}