{"uid":"cap_AUiThNFSlzJVLCiE8xFui","slug":"france-communes-full-text-search-by-name-geo-api-gouv-fr-e95802e7","name":"France Communes Full-Text Search by Name (geo.api.gouv.fr)","description":"France geo.api.gouv.fr full-text search of communes by name (ranked by population) Query: ?q= Returns JSON.","url":"https://clonecho.builda.company/x402/s/france-communes-search-by-name","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lIy2JF8W2_I5_SvEM5YJC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches French communes by name using the official geo.api.gouv.fr API, returning results ranked by population as JSON.","exampleAgentPrompt":"Search for French communes named 'Lyon' and return the results ranked by population.","exampleUseCases":[{"title":"Locating regional offices across France","prompt":"I need to find all French communes starting with 'Saint' so I can identify which ones have populations above 50,000 for our regional office expansion—can you search and rank them by size?"},{"title":"Validating customer addresses in France","prompt":"Our customer just entered 'Marseille' as their city but we need to make sure we're getting the official commune data and see what other similarly named towns exist in France—can you look that up?"},{"title":"Planning logistics distribution hubs","prompt":"We're setting up distribution centers and need to find all French communes named 'Paris' or containing 'Bourg' in the name, ranked by population so we can target the largest markets first."}],"resultDescription":"A JSON array of French communes matching the query string, sorted by population descending, with official administrative data for each matching municipality from geo.api.gouv.fr.","failureModes":["Empty or missing ?q= parameter returns no results or an error","Misspelled or non-existent commune name returns empty result set","API unavailability returns a server error","Very common or short query strings may return a large, unranked list"],"whenToPreferThis":"Use this endpoint when you need to search for French communes by name and want results ranked by population, leveraging the official French government geo.api.gouv.fr data. Prefer this over generic geocoding APIs when working specifically with French administrative commune data or when population-ranked results are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:05:09.070Z","isFirstParty":false}