NewAPIVerve Academy: free courses and certifications anyone can verify.Explore the Academy →

URL Lookup API

POST

Identify the hosting country and IP behind any web address.

URL Lookup resolves any web address to its hosting server IP address, country, and continent in real time. Paid plans add city, state, coordinates, timezone, and EU membership status.

Try it — live request, no key required

Request
POSTapi.apiverve.com/v1/urllookup
Body
Verification
Format

No key required to try it. Get a key to use it in your app.

Example
{
  "status": "ok",
  "error": null,
  "data": {
    "range": "",
    "country": "US",
    "region": "",
    "city": "Cheney",
    "timezone": "America/Chicago",
    "state": "Kansas",
    "zipcode": "67025",
    "coordinates": [
      37.751,
      -97.822
    ],
    "url": "https://www.merriam-webster.com/dictionary/documentation",
    "domain": "www.merriam-webster.com",
    "ip": "104.20.45.199",
    "countryName": "United States",
    "continent": "NA",
    "continentName": "North America",
    "accuracyRadius": 1000,
    "isEU": false
  }
}

About the URL Lookup API

A URL lookup API that resolves a web address to the server behind it and tells you where that server is. Send a URL and get back the domain, the IP address it resolves to, and the hosting country and continent, so you can check where a URL is hosted without running DNS and IP geolocation as two separate steps.

Security and fraud teams use it to see where links in emails or user submissions point, compliance teams use it to check whether a vendor's site is served from inside a given region, and analytics tools use it to group referring sites by hosting country.

The Free plan returns the URL and domain, the resolved IP, and the country and continent as both codes and full names. Paid plans add the city, state or region, postal code, timezone, latitude and longitude, an accuracy radius for those coordinates, and whether the hosting country is an EU member. Bear in mind that a site behind a CDN resolves to the CDN's nearest edge server, not the origin.

How it works

URL Lookup trims and lower-cases the url you POST, adds https:// when no scheme is given, and takes the hostname. Because the whole string is lower-cased, the url echoed back loses any upper-case characters in its path or query. An IP address used as the host is used as is. Otherwise the hostname is resolved for A records, and if it has none but exists, for AAAA records. The first address returned becomes ip; any others are ignored.

That address is looked up in the MaxMind GeoLite2 City database. country and continent are two-letter codes, with countryName and continentName in full. coordinates is a [latitude, longitude] pair, and accuracyRadius is the radius in kilometres within which the database places the address. When coordinates exist they are reverse-geocoded to the nearest known place, which replaces city, state and zipcode when it finds a match. region is the database's own subdivision value, timezone is an IANA name such as America/Chicago, and isEU reflects the hosting country's EU membership. range is always returned as an empty string.

A domain with no records returns a 404 ("no data found for the domain"), as does an address with no geolocation entry. If no resolver answers at all, the call returns a 503. Results are cached for 24 hours per URL.

Location describes the IP, so CDN-fronted, anycast and cloud-hosted sites report the edge or data centre that answered, not the company's office. On the Free plan region, city, state, zipcode, timezone, coordinates, range, accuracyRadius and isEU are removed.

What people use it for

Inbound Link Auditing
SEO and security analysts check the hosting country and IP address of external backlinks to spot foreign spam networks.
Data Sovereignty Compliance
Verify whether client-submitted website destinations host their data inside specific geographical boundaries or outside designated regulatory borders.
Suspicious Redirect Screening
To catch cloaked phishing campaigns, threat response teams inspect the resolved IP address and hosting country of reported URLs.
Ad Placement Verification
When auditing digital ad campaigns, media buyers trace destination landing pages back to their physical hosting server locations.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON
Default REST response
XML
Markup format
YAML
Human-readable
CSV
Tabular export
Beta
GraphQL
Query language
New
MCP
For AI agents

Other ways to use URL Lookup

Same data, same APIVerve account, same credit balance — one key works on all of them.

Questions.

Common questions about the URL Lookup API.

Read the docs →
What would checking 5,000 URLs a month cost me?
A Starter plan covers up to 20,000 URL lookups each month for 200,000 credits, which works out to $1.50 per 1,000 calls or about $0.0015 per lookup. At 5,000 lookups, you would use a quarter of your monthly allowance. If you only need occasional tests, the Free plan provides 20 lookups every month.
Do I get city, coordinates, and timezone details on the Free plan?
No, detailed geographic fields like city, state, postal code, timezone, coordinates, IP range, and EU status require a paid plan. The Free plan returns basic details including the domain, IP address, country, and continent. Upgrading to Starter or above unlocks all regional and location fields.
Does the URL parameter require an https prefix?
Yes, the URL parameter expects a complete URL including the protocol, such as https. Supplying a bare domain name without the protocol prefix can prevent the lookup from processing correctly. Make sure incoming web addresses retain their scheme before submitting them.
What information does each lookup return about a host?
Each call resolves the provided URL to its underlying IP address, extracting the domain along with its host country and continent. Paid plans add granular server details including the city, region, postal code, timezone, IP range, and geographic coordinates with an accuracy radius.
Can I use the resolved URL locations inside a commercial product?
Yes, all paid plans permit commercial use within your own software, internal tools, or client-facing dashboards. You are permitted to store and present the resolved hosting data to your users, but you cannot resell or redistribute the raw data feeds directly.

Ready to build with URL Lookup? Start with 200 free credits — one key unlocks all 300+ APIs.

Explore the catalog

300+ APIs on the same key and the same response shape.

Browse all APIs