IP 2 Country API
Overview
IP 2 Country is a free, no-auth API that maps any IPv4 address to its corresponding country. It is useful for basic geolocation features like redirecting users or showing region-specific content. Just pass an IP address as a query parameter to get the country code back.
Beginner Tip
This API only returns country-level data, not city or region. For more detailed IP geolocation, consider ipinfo.io or ip-api.com. It works well as a lightweight first step for country detection in backend scripts.
Available Data
Example Response
{
"name": "Japan",
"capital": "Tokyo",
"population": 125800000,
"region": "Asia",
"languages": [
"Japanese"
],
"flag": "https://flagcdn.com/jp.svg",
"currencies": [
{
"code": "JPY",
"name": "Japanese yen"
}
]
} Field Reference
countryCode ISO 3166-1 alpha-2 two-letter country code, e.g. US, DE, JP. countryCode3 ISO 3166-1 alpha-3 three-letter country code, e.g. USA, DEU, JPN. countryName Full English name of the country the IP belongs to. countryEmoji Flag emoji character for the country. Implementation Example
const url = "https://ip2country.info/";
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
Matrix Score Breakdown
Fully tested on Apr 5, 2026
Technical Specifications
Related Tags
Similar APIs
View All →administrative-divisons-db
⭐ Beginner's PickThe Administrative Divisions DB API provides a structured list of all administrative divisions (states, provinces, regions, cities) for countries around the world.
adresse.data.gouv.fr
⚠ Unavailableadresse.data.gouv.fr provides programmatic access to address database of france, geocoding and reverse via REST API.
Airtel IP
⭐ Beginner's PickAirtel 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.
bng2latlong
⭐ Beginner's Pickbng2latlong is a simple, free API that converts British National Grid (OSGB36) easting and northing coordinates into standard WGS84 latitude and longitude.
Cartes.io
⭐ Beginner's PickCartes.io is a free API that lets you create maps and add custom markers without signing up.