{"uid":"cap_4RQckfbNatMaw5whjvhk6","slug":"saylor-innovations-france-address-geocoder-adf2c494","name":"Saylor Innovations France Address Geocoder","description":"French address geocoder from the Base Adresse Nationale - coordinates, confidence, INSEE commune code, postcode, department and region for any address","url":"https://saylorinnovations.com/api/geocode/france?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 address or place, e.g. 8 bd du port amiens"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["query","results"],"properties":{"query":{"type":"string","description":"The query as the server interpreted it"},"source":{"type":"string","description":"Data source the values come from"},"results":{"type":"array","description":"List of matching results"},"returned":{"type":"number","description":"Number of items in this response"}}}}}}},"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_sWOoa3V8zPg0OLn9CLrrI","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":"Geocodes French addresses using the Base Adresse Nationale, returning coordinates, confidence score, INSEE commune code, postcode, department, and region","exampleAgentPrompt":"Can you geocode '8 boulevard du Port, Amiens' and give me the coordinates, postcode, department, and INSEE commune code for it?","exampleUseCases":[{"title":"Mapping delivery addresses in France","prompt":"I have a customer address — '14 rue de Rivoli, Paris' — can you look it up and get me the exact latitude and longitude plus the postcode and department?"},{"title":"Validating French address data","prompt":"I need to verify this French address is real and get its INSEE code: '25 avenue Jean Jaurès, Lyon'. Can you geocode it and tell me the confidence score?"},{"title":"Enriching a French business database","prompt":"We have a business located at '3 place de la République, Bordeaux' — can you fetch the full geographic details including region, department, and coordinates so I can add them to our records?"}],"resultDescription":"Returns a JSON object with the interpreted query string, data source attribution, number of results, and an array of matching address results — each containing coordinates (latitude/longitude), a confidence score, INSEE commune code, postcode, department name/code, and region name/code.","failureModes":["No results found for ambiguous or misspelled address — returns empty results array","Non-French addresses return no results as the BAN only covers France","Missing required 'q' query parameter returns an error","Very short or vague queries may return low-confidence or irrelevant results","Service unavailable or payment failure returns HTTP 402 or 5xx error"],"whenToPreferThis":"Choose this endpoint when you specifically need French address geocoding backed by the official Base Adresse Nationale dataset, which is the authoritative French government address registry. It is ideal when you need administrative metadata like INSEE commune codes, department, and region alongside coordinates — data that generic global geocoders often omit for France. Prefer it over general-purpose geocoders for French-language addresses, French administrative workflows, or when INSEE codes are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T19:25:50.485Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-france-address-geocoder-adf2c494"}