Location and Timezone API
Geocoding autocomplete with coordinates and timezone for astrology apps
Start building in seconds.
npm install @roxyapi/sdkimport { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.location.get(/* ... */)pip install roxy-sdkfrom roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
result = roxy.location.get(...) # async: await roxy.location.get_async(...)curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/location/claude mcp add --transport http \
roxy-location https://roxyapi.com/mcp/location \
--header "X-API-Key: YOUR_KEY"AI agents auto-discover all endpoints as callable tools. Zero configuration.
Want to ship faster? Clone a free starter app and go from zero to production in 30 minutes.
Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app in minutes.
[
{
"city": "Tokyo",
"province": "Tokyo",
"country": "Japan",
"iso2": "JP",
"latitude": 35.6762,
"longitude": 139.6503,
"timezone": "Asia/Tokyo",
"utcOffset": 9,
"population": 13960000
}
]Structured JSON with documented fields. Not hallucinated text. See all endpoints
Works with your stack
City search and geocoding API + hosted MCP for AI agents and astrology apps. Connect Claude Code, Cursor, VS Code in seconds, no local setup. 7,000+ cities across 227 countries. Returns latitude, longitude, IANA timezone, and DST-aware UTC offset. The location layer for birth chart forms, horoscope apps, event planners, and any feature that needs place-to-coordinates resolution.
Key Features
Everything you need from our Location and Timezone API, built for production:
City autocomplete search across 7,000+ cities worldwide, sorted by relevance and population
Latitude, longitude, IANA timezone, and UTC offset in every result for direct use in astrology APIs
Global coverage across 227 countries with ISO 3166 codes
DST-aware UTC offset that adjusts automatically for daylight saving time
Fully offline dataset with sub-5ms response times, no external geocoding API dependencies
Response fields map directly to astrology API parameters for seamless integration
All Endpoints
Click any endpoint to view detailed documentation, parameters, and response examples.
Search cities worldwide - Geocoding autocomplete with coordinates and timezone
City autocomplete and geocoding search across 7,000+ locations in 227 countries. Returns geographic coordinates (latitude, longitude), IANA timezone, and DST-aware UTC offset for each match. Built for birth chart location pickers, horoscope apps, event scheduling, and any feature requiring place-to-coordinates resolution. Partial name matching with intelligent ranking: exact prefix matches first, then sorted by population for relevance. Covers all major cities in Europe, Americas, Asia, Africa, and Oceania.
List all 227 countries - ISO codes and city coverage
Returns all 227 countries with ISO 3166-1 alpha-2 and alpha-3 codes, plus the number of searchable cities per country. Use this endpoint to build country dropdown menus, regional filters, or to check city coverage before querying. Sorted alphabetically by country name. Covers Europe, Americas, Asia, Middle East, Africa, and Oceania.
Get cities in a country - Geocoding directory sorted by population
Returns all cities for a specific country, identified by ISO 3166-1 alpha-2 code (e.g. DE for Germany, FR for France, GB for United Kingdom, US for United States). Each city includes geographic coordinates, IANA timezone, and DST-aware UTC offset for direct use in astrology birth chart, horoscope, transit, and panchang calculations. Cities sorted by population with the largest metropolitan areas first.
What You Can Build with Location and Timezone API
Real-world applications and use cases for integrating Location and Timezone API into your projects:
Birth chart location picker: autocomplete city search that auto-fills latitude, longitude, and timezone
Event location for transits: get coordinates and timezone for planetary transit and panchang calculations
Timezone conversion: look up IANA timezone and current UTC offset for any city worldwide
Country and city directory: browse all 227 countries and their cities for location dropdowns and filters
What developers are saying
Dhani M.
Indie App Developer
Shipped an astrology app over a long weekend. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they line up with my reference. One API key for all of it.
Tom H.
Senior Developer
The OpenAPI spec is the most complete I have seen in this space. Generated a type-safe TypeScript client from it in seconds. Every field has descriptions and examples. Production-grade documentation.
Chris W.
Backend Engineer
Response times consistently under 50ms for numerology and tarot endpoints. The API returns structured JSON with every field documented. Integrated it into our platform in an afternoon.
Getting started with Location and Timezone API.
From zero to production in 3 steps. No signup required for testing.
3 Steps to Ship
| 1Install the SDK | npm i @roxyapi/sdk |
| 2Get your API key | View Plans |
| 3Make your first call | View Docs |
Agent-Ready Infrastructure
MCPThe only MCP server covering 10 spiritual domains under one key
- MCP server — tools auto-discovered by Claude, ChatGPT, Cursor
- llms.txt — AI-native documentation for code generation
- AGENTS.md — Included in SDK for GitHub Copilot, Windsurf, Cline
Start using Location and Timezone API today.
Geocoding autocomplete with coordinates and timezone for astrology apps
All 10 domains included with every plan. 3+ endpoints, MCP server, SDK, and starters.
Plans from $39/mo — thats $3.90 per domain. No credit card required for testing.
View Pricing & Get API Key