M
API Matrix

Geocode.xyz API

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

Overview

Geocode.xyz is a free worldwide geocoding API that supports forward and reverse geocoding, batch operations, and geoparsing of natural language text. It covers global addresses without requiring an API key for basic use, making it very accessible for beginners. You can even extract location mentions from free-form text using its geoparsing feature.

💡

Beginner Tip

Without an API key you may experience rate limiting with a 1-second delay between requests. For faster access and batch geocoding of multiple addresses at once, register for a free API key.

Available Data

IP address details
latitude and longitude
city and country
timezone
ISP information

Example Response

JSON Response 
{
  "status": "success",
  "data": {
    "result": "Data from Geocode.xyz",
    "description": "Provides worldwide forward/reverse geocoding, batch geocoding and geoparsing",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

longt Longitude of the geocoded location as a string in decimal degrees.
latt Latitude of the geocoded location as a string in decimal degrees.
standard.addresst Parsed street address component of the result.
standard.city City name extracted from or matched to the queried address.
standard.countryname Full country name where the geocoded location is situated.
standard.prov Province, state, or region code associated with the geocoded result.

Implementation Example 

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://geocode.xyz/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

Throttled response with "throttled" in JSON Exceeding the free rate limit of one request per second without an API key.
✓ Add a 1-second delay between requests, or register for a free API key at geocode.xyz to increase your limit.
latt and longt fields show 0.0 The address could not be found or the query is too vague.
✓ Provide a more specific address including city and country. Check that the address is spelled correctly.
Batch request returns partial results Some addresses in a batch could not be resolved.
✓ Check for null or zero values in the batch response and retry those individual addresses with more detail.

Matrix Score Breakdown

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

Fully tested on Apr 5, 2026

Technical Specifications

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

Alternatives to Geocode.xyz

Technical alternatives for different use cases.

Geocod.io

Excellent US/Canada geocoding with census data appending

Better For

US-focused applications needing address verification

Trade-off

Global geocoding outside North America

OpenCage

Aggregates multiple geocoding sources for better coverage

Better For

Global geocoding with consistent quality

Trade-off

Free usage without rate limits

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