Can IPGeolocation.io Return Place Names in Other Languages?

Abdullah Afzal
By Abdullah Afzal Database Engineer @IPGeolocation.io
Posted on November 2, 2026 | 5 min read
Can IPGeolocation.io Return Place Names in Other Languages?
Back to Help Center

Yes. IPGeolocation.io returns place names in other languages when you add the lang parameter to a lookup on a paid API plan: continent, country, capital, state, district, and city names in 13 languages, from German and Japanese to Standard Arabic. IPGeolocation.io's location databases carry the same names in 12 languages, every one but Arabic.

English is the default, so a request without lang stays in English. A request with it costs the same credits and keeps the same response shape: only the names change, while codes, coordinates, and time zone names stay as they are.

These are the languages and the code to send for each:

LanguageLang ValueDatabase CSV Column
Englishenplace_english
Germandeplace_german
Russianruplace_russian
Japanesejaplace_japanese
Frenchfrplace_french
Chinese (Simplified)cnplace_chinese
Spanishesplace_spanish
Czechcsplace_czech
Italianitplace_italian
Koreankoplace_korean
Persianfaplace_persian
Portugueseptplace_portuguese
Standard ArabicarAPI only

We build these names with a translation pipeline that turns each English place name into the other languages, and a dedicated reviewer on our team checks every newly added translation. By our count, as of October 2026, the API has names for about 415,000 places, and nearly every one of them has a name in each of the 13 languages.


How to ask for place names in another language

Add lang to the lookup with a code from the table. This request looks up the address of Charles University's web server in Prague, asks for Japanese, and keeps only the location object:

bash

# Paid plan key in IPGEO_API_KEY; a Free key gets HTTP 401 for any lang other than en
curl -sS "https://api.ipgeolocation.io/v3/ipgeo?apiKey=${IPGEO_API_KEY}&ip=195.113.89.54&lang=ja&fields=location"

The response, trimmed to the place names and the codes beside them:

json

{
  "ip": "195.113.89.54",
  "location": {
    "continent_code": "EU",
    "continent_name": "ヨーロッパ",
    "country_code2": "CZ",
    "country_name": "チェコ",
    "country_name_official": "チェコ",
    "country_capital": "プラハ",
    "state_prov": "プラハ",
    "state_code": "CZ-PR",
    "district": "プラハ1区",
    "city": "プラハ",
    "zipcode": "110 00",
    "geoname_id": "10299907"
  }
}

Every name is in Japanese, while continent_code, country_code2, state_code, the postal code, and geoname_id are exactly what an English request returns.

A bulk lookup applies one lang value to every address in the request. The Time Zone API takes it when you look up a time zone by IP address: the location fields change, and the written-out date in date_time_txt stays in English. The code isn't case-sensitive, so DE works like de. Every IPGeolocation.io SDK accepts the same 13 values, and the IP Geolocation API documentation has the full parameter reference.


Which fields change, and which stay the same

In an IPGeolocation.io response, the place-name fields change with lang: continent_name, country_name, country_name_official, country_capital, state_prov, district, and city, plus the optional locality field when the response includes it. Codes, the geoname_id, coordinates, the currency name, time zone names, ASN and company names, and every JSON key stay exactly as an English request returns them.

Here is the same Prague address in four languages:

FieldEnglishCzechGermanJapanese
continent_nameEuropeEvropaEuropaヨーロッパ
country_nameCzech RepublicČeská republikaTschechische Republikチェコ
country_capitalPraguePrahaPragプラハ
state_provPraguePrahaPragプラハ
districtPraha 1Praha 1Prag 1プラハ1区
cityPraguePrahaPragプラハ
Three IPGeolocation.io lookups of one address in English, German, and Japanese: place names change, codes stay the same

Not every name differs between languages. A place with no German name of its own keeps the one it has: Google's public DNS service at 8.8.8.8 comes back with the city "Mountain View" under lang=de, while its state turns into "Kalifornien".

If you save lookup results, key them on the codes and the geoname_id, not on the names. They're the same in every language, while a city saved from one German request and one English request lands in your data twice, as "Prag" and as "Prague". Store the name next to its key, in the language you display.


Errors you might see

  • HTTP 401 with a Free plan key. IPGeolocation.io's Free plan answers in English only, so any lang value other than en returns 401 Unauthorized. What the Free plan includes lists the other paid-only options.
  • HTTP 400 for a code that isn't on the list. A language we don't support, or a typo, returns an error that names the code, such as This 'tr' lang is not valid. Please use 'en' as the default language.
  • An empty name. A missing translation is rare, but when a place has no name in the language you asked for, that field comes back empty rather than in English. Treat an empty name as missing and fall back to English: from a second lookup with lang=en, which uses another credit, or from the database's place_english column, which is never empty.

The 401 and the 400 use no credits, because only successful (HTTP 200) responses are charged.


Place names in the IPGeolocation.io databases

IPGeolocation.io's IP to Country, IP to City, and IP to Location databases ship multilingual place names in 12 languages, the API's list without Standard Arabic. Every one of these databases carries all 12, so there's no parameter to set: you choose the language when you read the data.

  • CSV archives: every archive includes db-place.csv.gz, with one row per place and one column per language, such as place_english and place_japanese. In the IP to City and IP to Location archives, the file of IP ranges, db-ip-location.csv.gz, points to it through state_place_id, district_place_id, and city_place_id; in all three archives, db-country.csv.gz does the same for continent, country, and capital names.
  • MMDB files: each name is an object keyed by language code, so one lookup returns all 12 forms at once and your code picks the one it needs.

In the rare case a translation is missing, the value is an empty string, never null, so the English fallback in the errors section applies to the files too. How the CSV and MMDB archives are organized covers the rest of each archive, and the IP to Location database field reference lists every name field.

FAQ

No. IPGeolocation.io returns place names in languages other than English on paid API plans only, and every paid plan includes them, starting with Starter at $19 a month for 150,000 credits. The Free plan, with 1,000 credits a day, answers any lang other than en with HTTP 401 and charges no credits for it. API pricing compares the plans.

No. An IPGeolocation.io lookup with lang costs the same as one without: 1 credit for the standard response. Only security data (2 more credits) and abuse contact data (1 more) add to the cost, as how IPGeolocation.io credits are charged explains.

Not directly. The lang parameter sets the language of the response, not the visitor's. IPGeolocation.io's country_metadata.languages field lists the languages spoken in the visitor's country, ["cs", "sk"] for the Czech Republic, which doesn't say which one, if either, this visitor reads. The geo-redirect guide explains why a visitor's country doesn't tell you their language.

Ask us. The IPGeolocation.io API covers 13 languages and the databases 12, and we can add support for another language on request: contact our team with the language you need.

Related Help Articles

What Is IPGeolocation.io? Key Facts on Its Products, Data, and Plans
What Is IPGeolocation.io? Key Facts on Its Products, Data, and Plans

IPGeolocation.io turns public IPv4 and IPv6 addresses into location, security, network, and company data through APIs, databases, and Snowflake. Here are the facts on each product, how the data is delivered, and how plans and credits work.

Posted on November 1, 2026
Read More
Which IPGeolocation.io Product Should I Use?
Which IPGeolocation.io Product Should I Use?

Match your job to the right IPGeolocation.io product. One IP Geolocation API call covers most jobs; here is when a dedicated API, real-time VPN detection, or a database fits better.

Posted on October 30, 2026
By Abdul Mateen
Read More
Does IPGeolocation.io Store the IP Addresses You Look Up?
Does IPGeolocation.io Store the IP Addresses You Look Up?

IPGeolocation.io keeps standard API access logs, including the IP addresses you look up, for 14 days and then deletes them. Here is what a log line holds, what we never do with it, and how to look up IP data without sending IPs at all.

Posted on October 29, 2026
Read More
Does IPGeolocation.io Offer Annual and Multi-Year Contracts?
Does IPGeolocation.io Offer Annual and Multi-Year Contracts?

Annual billing on IPGeolocation.io API plans gives you two months free, Enterprise API contracts can run for up to three years, and database contracts run one to three. Here's what each term changes, from credits to renewal.

Posted on October 28, 2026
Read More
How Does IPGeolocation.io Database Licensing Work?
How Does IPGeolocation.io Database Licensing Work?

IPGeolocation.io database licensing comes down to where the files run, whether the use is internal or customer-facing, and how many servers run them. Here are the six license types, how servers are counted, and what the term covers.

Posted on October 25, 2026
Read More
Is the IPGeolocation.io Free Plan Really Free?
Is the IPGeolocation.io Free Plan Really Free?

The IPGeolocation.io Free plan costs $0 and needs no credit card. Here's what its 1,000 daily credits cover, what needs a paid plan, and what happens at the daily limit.

Posted on October 24, 2026
Read More

Subscribe to Our Newsletter

Get the latest in geolocation tech, straight to your inbox.