{"uid":"cap_RYFCh14C6LGLMOEToBVtC","slug":"saylor-innovations-france-commune-lookup-e9d8033c","name":"Saylor Innovations France Commune Lookup","description":"French commune lookup - name or postcode to INSEE code, population, department, region and coordinates from geo.api.gouv.fr","url":"https://saylorinnovations.com/api/france/communes?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"French commune name or five-digit postcode"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["query","communes"],"properties":{"query":{"type":"string","description":"The query as the server interpreted it"},"source":{"type":"string","description":"Data source the values come from"},"communes":{"type":"array"},"matched_by":{"type":"string","description":"Matched by"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IceDrAd96DezumlZcm_V5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up French communes by name or postcode, returning INSEE code, population, department, region, and coordinates","exampleAgentPrompt":"Can you look up the commune details for 'Lyon' in France — I need the INSEE code, department, region, and coordinates?","exampleUseCases":[{"title":"Validate French address administrative data","prompt":"I have a French postcode '75008' — can you resolve it to the commune name, INSEE code, and which department and region it belongs to?"},{"title":"Geocode a French town for mapping","prompt":"What are the geographic coordinates and region for the commune of Bordeaux in France? I need the official INSEE code too."},{"title":"Enrich a database of French customers","prompt":"For each of my French customers, I need to enrich their records with the INSEE code, population, department, and region — can you start with the commune 'Montpellier'?"}],"resultDescription":"Returns the interpreted query string, data source attribution, and an array of matching communes — each containing the commune's name, INSEE code, postal code(s), population count, department number and name, region name, and geographic coordinates (latitude/longitude).","failureModes":["No matching commune found for given name or postcode — empty communes array returned","Ambiguous query matching multiple communes — multiple results returned requiring disambiguation","Invalid or malformed postcode format — may return no results or unexpected matches","API upstream failure from geo.api.gouv.fr — service may return error or degraded response","Rate limiting or payment failure via x402 protocol — request rejected before reaching data source"],"whenToPreferThis":"Choose this endpoint when you need official French administrative data (INSEE codes, department/region hierarchy, population, coordinates) for a commune identified by name or postcode. It is backed by the authoritative French government geo API (geo.api.gouv.fr), making it preferable to generic geocoding services when INSEE codes or official administrative classifications are specifically required. Ideal for enriching French address data, building administrative hierarchies, or validating French locality references.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:43:55.574Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-france-commune-lookup-e9d8033c"}