Geocoding API

REST API to convert city names to latitude/longitude coordinates. Get precise geographic coordinates with a single API call.

Features

• Convert any city name to lat/long coordinates
• Filter by state and country code for accuracy
• Covers cities worldwide
• 100 requests/month on free tier
• Example Response:

{
  "name": "New York",
  "state": "New York",
  "country_code": "US",
  "coordinates": {
    "latitude": 40.7127281,
    "longitude": -74.0060152
  }
}

Get API Key

Create an account at omkar.cloud to get your API key, and use it in requests. 100 requests are free every month.

Quick Start

curl -X GET "https://geocoding-api.omkar.cloud/geocode?city=New%20York" \
  -H "API-Key: YOUR_API_KEY"

[
  {
    "name": "New York",
    "state": "New York",
    "country_code": "US",
    "coordinates": {
      "latitude": 40.7127281,
      "longitude": -74.0060152
    }
  }
]

Installation

Python

pip install requests

import requests

response = requests.get(
    "https://geocoding-api.omkar.cloud/geocode",
    params={"city": "New York"},
    headers={"API-Key": "YOUR_API_KEY"}
)

data = response.json()[0]
print(f"Coordinates: {data['coordinates']['latitude']}, {data['coordinates']['longitude']}")

Node.js

npm install axios

import axios from "axios";

const response = await axios.get("https://geocoding-api.omkar.cloud/geocode", {
    params: { city: "New York" },
    headers: { "API-Key": "YOUR_API_KEY" }
});

console.log(`Coordinates: ${response.data[0].coordinates.latitude}, ${response.data[0].coordinates.longitude}`);

API Reference

Endpoint

GET https://geocoding-api.omkar.cloud/geocode

Headers

Header	Required	Description
API-Key	Yes	API key from omkar.cloud/api-key

Parameters

Parameter	Required	Description
city	Yes	City name to geocode (e.g., "London", "Tokyo")
state	No	State/region to disambiguate same-named cities
country_code	No	Two-letter ISO country code (e.g., "US", "GB", "JP")

Response Fields

Field	Type	Description
name	string	City/place name
state	string	State or province
country_code	string	Two-letter ISO country code
coordinates	object	Contains latitude and longitude

Examples

Basic city lookup

response = requests.get(
    "https://geocoding-api.omkar.cloud/geocode",
    params={"city": "London"},
    headers={"API-Key": "YOUR_API_KEY"}
)

location = response.json()[0]
print(f"{location['name']}: {location['coordinates']['latitude']}, {location['coordinates']['longitude']}")

Filter by country

response = requests.get(
    "https://geocoding-api.omkar.cloud/geocode",
    params={
        "city": "Paris",
        "country_code": "FR"
    },
    headers={"API-Key": "YOUR_API_KEY"}
)

location = response.json()[0]
print(f"{location['name']}, {location['country_code']}")

Filter by state (US cities)

response = requests.get(
    "https://geocoding-api.omkar.cloud/geocode",
    params={
        "city": "Portland",
        "state": "Oregon"
    },
    headers={"API-Key": "YOUR_API_KEY"}
)

location = response.json()[0]
print(f"{location['name']}, {location['state']}")

Error Handling

response = requests.get(
    "https://geocoding-api.omkar.cloud/geocode",
    params={"city": "New York"},
    headers={"API-Key": "YOUR_API_KEY"}
)

if response.status_code == 200:
    data = response.json()
elif response.status_code == 401:
    # Invalid API key
    pass
elif response.status_code == 429:
    # Rate limit exceeded
    pass

Rate Limits

Plan	Price	Requests/Month
Free	$0	100
Starter	$16	3,000
Grow	$48	15,000
Scale	$148	75,000

Questions? We have answers.

Reach out anytime. We will solve your query within 1 working day.