GeoApi API

Free to Use Varies (check documentation)
77 B
Measured Score 0 50 100 Reachability 30/30 Speed 5/20 Security 15/15 Developer XP 12/20 Reliability 15/15 TESTED 2026-07-23

Overview

GeoApi is a free French government API that provides official geographical data for France, including communes, departments, regions, and administrative boundaries. It is maintained by the French government and offers reliable, up-to-date data with no authentication required. Ideal for applications targeting French users or requiring French administrative divisions.

Beginner Tip

All data is focused on France and its overseas territories; it is not a global geocoding service. Use the /communes endpoint with a postal code or name to find French municipalities quickly.

Available Data

IP address details
latitude and longitude
city and country
timezone
ISP information
Use case: Integrate french geographical data data into web and mobile applications

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from GeoApi",
    "description": "French geographical data",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

nom Official name of the commune, department, or region in French.
code INSEE code uniquely identifying the administrative unit within France.
codesPostaux List of postal codes (ZIP codes) associated with the commune.
departement Nested object with the code and name of the department this commune belongs to.
region Nested object with the code and name of the region this commune belongs to.
centre GeoJSON point geometry representing the geographic center of the administrative unit.

Implementation Example

Request
// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://api.gouv.fr/api/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Empty array response The search name or code does not match any French administrative unit.
Check for accented characters in French place names. Try partial names using the "nom" parameter.
400 Bad Request with field errors Requesting a field name that does not exist for the endpoint.
Refer to the API documentation for each endpoint's available fields. Common fields are nom, code, codeDepartement, codeRegion.
Large response payload Requesting geometry data for many communes at once returns a lot of data.
Use the "fields" parameter to request only the data you need, and paginate or filter by department to reduce response size.

Measured Score Breakdown

Live HTTP request to the API endpoint

Reachability 30/30
Speed 5/20
Security 15/15
Developer XP 12/20
Reliability 15/15
Endpoint Response Time 1494ms

Fully tested on Jul 23, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS UNKNOWN
Category Geocoding
Difficulty Beginner
Verified: 2026-04-07

Related Tags

Similar APIs

View All →