For Developers

TimeNowHub API

We believe in an open web. Our core city database and logic endpoints are free to use for non-commercial projects.

GET /api/cities

Returns a full list of supported cities with timezone, coordinates, and population data.

Response Example (JSON)

[
  {
    "name": "Tokyo",
    "slug": "tokyo",
    "timezone": "Asia/Tokyo",
    "country": "Japan",
    "lat": 35.6762,
    "lng": 139.6503,
    "population": 37274000
  },
  ...
]

GET /api/seo/:city

Retrieve SEO metadata and structured data for a specific city.

Response Example (JSON)

{
  "title": "Time in Tokyo Now...",
  "description": "Current local time in Tokyo...",
  "jsonLd": { "@type": "Place", ... }
}

GET /api/seo/compare/:city1/:city2

Get comprehensive meeting overlap logic, descriptions, and FAQ schema for two cities.

Response Example (JSON)

{
  "title": "Best Meeting Time: London to New York...",
  "description": "Sync London and New York easily...",
  "answer": "Excellent overlap! The best window...",
  "jsonLd": { "@type": "HowTo", ... }
}

GET /api/internal/dst-alerts

Retrieve upcoming Daylight Saving Time transitions for a set of cities.

Response Example (JSON)

[
  {
    "city": "London",
    "changeDate": "2026-03-29",
    "direction": "spring"
  }
]

GET /api/internal/solar-data/:city

Calculate sunrise, sunset, and golden hour data server-side.

Response Example (JSON)

{
  "sunrise": "06:42",
  "sunset": "18:15",
  "goldenHour": "17:30"
}

Fair Use Policy

Please cache your requests. This API runs on the Edge, but we appreciate you being gentle. Commercial use? Contact us for a dedicated key.