{"uid":"cap_jJu9TrDL3C1rewADDQKwZ","slug":"eu-weather-geo-sunrise-sunset-a32dfaf7","name":"EU Weather & Geo – Sunrise/Sunset","description":"Weather and geo utilities for AI agents, paid per call in USDC via x402 (no account, no API key): current weather and up-to-9-day daily forecasts for any city or lat/lon (MET Norway open data, CC BY 4.0), city geocoding with time zones (GeoNames, CC BY 4.0) and sunrise/sunset. Errors are never charged.","url":"https://eu-weather-geo.frcompanycheck.workers.dev/v1/sun?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"lat":{"type":"number","description":"Latitude (if no city)"},"lon":{"type":"number","description":"Longitude (if no city)"},"city":{"type":"string","example":"Paris","description":"City name, optionally ',CC' (e.g. Lyon,FR); cities >= 50k inhabitants"},"date":{"type":"string","description":"YYYY-MM-DD (default today UTC)"},"country":{"type":"string","description":"ISO country code to disambiguate"},"timezone":{"type":"string","description":"IANA zone for local times/days (default: city zone or UTC)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"date":"2026-06-21","sunset_local":"2026-06-21T21:58:00","sunrise_local":"2026-06-21T05:47:00","day_length_minutes":971}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_k458rbcBe_F0IMSOhI7RD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns sunrise time, sunset time, and day length in minutes for a given city or latitude/longitude on a specific date.","exampleAgentPrompt":"What time does the sun rise and set in Lyon, France on June 21, 2026, and how many minutes of daylight will there be?","exampleUseCases":[{"title":"Golden hour photography planning","prompt":"I'm doing a photo shoot outdoors in Barcelona on July 14th — what time does the sun rise and set, and how many minutes of daylight will I have?"},{"title":"Travel itinerary daylight check","prompt":"We're visiting Reykjavik on December 22nd. What time will the sun rise and set, and how short is the day there in winter?"},{"title":"Outdoor event scheduling","prompt":"I'm planning an evening garden party in Rome on August 10th — what time does it get dark so I know when to start setting up lights?"}],"resultDescription":"A JSON object with the date, local sunrise datetime, local sunset datetime, and total day length in minutes for the requested location and date.","failureModes":["City not found or population below 50k threshold — 404 or empty result","Ambiguous city name without country code — wrong city returned","Invalid date format (not YYYY-MM-DD) — 400 validation error","Missing both city and lat/lon — 400 missing parameter error","Payment failure via x402 — 402 response, no charge applied"],"whenToPreferThis":"Choose this endpoint when you need precise local sunrise/sunset times or day length for a specific city or coordinate on a specific date, paid per-call in USDC without requiring an account or API key. It is ideal for lightweight, on-demand astronomical lookups without the overhead of a subscription service.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:39:36.665Z","isFirstParty":false,"canonicalSlug":"eu-weather-geo-sunrise-sunset-a32dfaf7"}