API Documentation
Access real-time sunset data for 195 world capitals programmatically.
🚧 Coming Soon — Join the Waitlist
Our API is currently in development. Join the waitlist for early access with 50% off for the first 6 months. Email: [email protected]
⚡ Key Features
Sunset & Sunrise
Precise times for any of our 195 capital cities
Golden & Blue Hour
Exact timing windows for photography planning
Weather Data
Cloud cover, visibility, wind speed, viewing quality
Forecasts
Up to 30-day sunset forecasts for any location
Coordinates
Look up sunset data by lat/lon coordinates
Fast & Reliable
99.9% uptime SLA with low-latency responses
📡 Endpoints
Get Sunset by City
GET /api/v1/sunset/{city}
GET https://api.sunset-tracker.com/v1/sunset/london
{
"city": "London",
"country": "United Kingdom",
"coordinates": { "latitude": 51.5074, "longitude": -0.1278 },
"date": "2025-01-02",
"sunset": { "utc": "16:02", "local": "16:02", "timestamp": 1735837320 },
"sunrise": { "utc": "08:06", "local": "08:06", "timestamp": 1735808760 },
"goldenHour": { "start": "15:02", "end": "16:02" },
"blueHour": { "start": "16:17", "end": "16:47" },
"dayLength": "07:56",
"weather": { "condition": "Clear", "temperature": 8, "cloudCover": 15, "viewingQuality": 5 }
}
Get Sunset by Coordinates
GET /api/v1/sunset/coordinates
GET https://api.sunset-tracker.com/v1/sunset/coordinates?lat=40.7128&lon=-74.0060
{
"coordinates": { "latitude": 40.7128, "longitude": -74.0060 },
"nearestCity": "Washington",
"distance": 328.5,
"sunset": { ... },
"sunrise": { ... }
}
Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
| city | string | City name (e.g., "london", "paris") | Yes |
| lat | float | Latitude (-90 to 90) | Yes* |
| lon | float | Longitude (-180 to 180) | Yes* |
| date | string | YYYY-MM-DD format (default: today) | No |
| days | integer | Forecast days (1-30) | No |
* Required for coordinate-based queries
🔑 Authentication
All requests require an API key in the header:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.sunset-tracker.com/v1/sunset/tokyo
💰 Pricing Plans
Starter
$29
per month
- 10,000 requests/month
- Full data + weather
- Golden & blue hour
- Email support
- 99.9% SLA
💡 Use Cases
Photography Apps
Help photographers plan perfect shots with golden hour timing
Travel Platforms
Show sunset times for destinations to help travelers plan
Weather Apps
Enhance forecasts with precise sunset/sunrise data
Smart Home
Automate lighting based on actual sunset times
Event Planning
Plan outdoor events with accurate sunset predictions
Gaming
Create realistic day/night cycles from real-world data
🎁 Early Adopter Benefits
Join now: 50% off for 6 months · Priority access · Lifetime pricing · Feature input · Free migration help.
Contact: [email protected]