M
API Matrix

GeoApi API

Geocoding / No Auth Required Beginner HTTPS
Free to Use Varies (check documentation)
82 Score
Grade A
Visit Official Site Compare Alternatives

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 

// ⚠️ 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.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 15/20
✓ Reliability 7/15
Response Time 283ms

Fully tested on Apr 5, 2026

Technical Specifications

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

Similar APIs

View All →

administrative-divisons-db

⭐ Beginner's Pick
92

The Administrative Divisions DB API provides a structured list of all administrative divisions (states, provinces, regions, cities) for countries around the world.

No Auth Beginner HTTPS 40ms

adresse.data.gouv.fr

0

adresse.data.gouv.fr provides programmatic access to address database of france, geocoding and reverse via REST API.

No Auth Beginner HTTPS 638ms

Airtel IP

⭐ Beginner's Pick
57

Airtel IP is a free, no-auth IP geolocation API that aggregates data from multiple sources to return the country associated with any given IP address.

No Auth Beginner HTTPS 146ms

bng2latlong

⭐ Beginner's Pick
57

bng2latlong is a simple, free API that converts British National Grid (OSGB36) easting and northing coordinates into standard WGS84 latitude and longitude.

No Auth Beginner HTTPS 389ms

Cartes.io

⭐ Beginner's Pick
87

Cartes.io is a free API that lets you create maps and add custom markers without signing up.

No Auth Beginner HTTPS 55ms