Geoapify API

⭐ Beginner's Pick Geocoding / API Key Intermediate HTTPS CORS
Varies by plan (check documentation)

Overview

Geoapify is a powerful geocoding API that converts addresses to coordinates (forward geocoding) and coordinates to addresses (reverse geocoding), with address autocomplete support. It offers a generous free tier with 3,000 requests per day, making it great for learning and small projects. An API key is required but easy to obtain with free registration.

💡

Beginner Tip

Start with the free tier which gives 3,000 API calls per day — plenty for development and small apps. Always URL-encode your address strings to handle spaces and special characters properly.

Available Data

IP address details
latitude and longitude
city and country
timezone
ISP information
vehicle make and model

Example Response

JSON Response
{
  "make": "Toyota",
  "model": "Camry",
  "year": 2025,
  "engine": "2.5L 4-cylinder",
  "fuel_economy": {
    "city_mpg": 28,
    "highway_mpg": 39
  },
  "msrp": 28400
}

Field Reference

features GeoJSON FeatureCollection array; each element represents a geocoding result.
properties.formatted Full formatted address string for the geocoded location.
properties.lat Latitude coordinate of the geocoded location in decimal degrees.
properties.lon Longitude coordinate of the geocoded location in decimal degrees.
properties.confidence Confidence score from 0 to 1 indicating how well the result matches the input query.
properties.country_code Two-letter ISO country code for the location (e.g., "us", "de").

Implementation Example

const url = "https://www.geoapify.com/api/geocoding-api/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
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

401 Unauthorized Missing or incorrect API key in the request.
Include your API key as the "apiKey" query parameter. Register at geoapify.com to get a free key.
Empty features array The address string is too vague, misspelled, or in an unsupported format.
Use a complete address with street, city, and country for best results. Check the "rank" field in responses to gauge confidence.
429 Too Many Requests Exceeded the free tier limit of 3,000 requests per day.
Implement request caching, batch your geocoding operations, or upgrade to a paid plan for higher limits.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 10/20
🔒 Security 15/15
🛠 Developer XP 17/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS YES
Category Geocoding
Difficulty Intermediate
Verified: 2026-04-07

Similar APIs

View All →