{"openapi":"3.1.0","info":{"title":"Apizie: places","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://zieapi.vercel.app"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/places:open-meteo/forecast":{"get":{"operationId":"places_open_meteo_forecast","summary":"Forecast","description":"Current conditions plus hourly and daily forecast for a coordinate.","tags":["places"],"parameters":[{"name":"latitude","in":"query","required":true,"schema":{"type":"number"},"example":48.8566},{"name":"longitude","in":"query","required":true,"schema":{"type":"number"},"example":2.3522},{"name":"current","in":"query","required":false,"description":"Comma-separated current variables","schema":{"type":"string","default":"temperature_2m,relative_humidity_2m,apparent_temperature,precipitation,weather_code,wind_speed_10m","description":"Comma-separated current variables"}},{"name":"hourly","in":"query","required":false,"description":"Comma-separated hourly variables, e.g. temperature_2m,precipitation_probability","schema":{"type":"string","description":"Comma-separated hourly variables, e.g. temperature_2m,precipitation_probability"}},{"name":"daily","in":"query","required":false,"description":"Comma-separated daily variables","schema":{"type":"string","default":"temperature_2m_max,temperature_2m_min,precipitation_sum,sunrise,sunset","description":"Comma-separated daily variables"}},{"name":"forecastDays","in":"query","required":false,"schema":{"type":"integer","default":7,"minimum":1,"maximum":16}},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"auto"}},{"name":"temperatureUnit","in":"query","required":false,"schema":{"type":"string","enum":["celsius","fahrenheit"],"default":"celsius"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":900,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:open-meteo/history":{"get":{"operationId":"places_open_meteo_history","summary":"Historical weather","description":"Daily weather history from the ERA5 archive (1940 to a few days ago).","tags":["places"],"parameters":[{"name":"latitude","in":"query","required":true,"schema":{"type":"number"},"example":40.71},{"name":"longitude","in":"query","required":true,"schema":{"type":"number"},"example":-74.01},{"name":"startDate","in":"query","required":true,"schema":{"type":"string"},"example":"2024-01-01"},{"name":"endDate","in":"query","required":true,"schema":{"type":"string"},"example":"2024-01-31"},{"name":"daily","in":"query","required":false,"schema":{"type":"string","default":"temperature_2m_max,temperature_2m_min,precipitation_sum"}},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"auto"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:open-meteo/air-quality":{"get":{"operationId":"places_open_meteo_air_quality","summary":"Air quality","description":"Current and hourly air quality (PM2.5, PM10, ozone, US and European AQI).","tags":["places"],"parameters":[{"name":"latitude","in":"query","required":true,"schema":{"type":"number"},"example":28.61},{"name":"longitude","in":"query","required":true,"schema":{"type":"number"},"example":77.21},{"name":"current","in":"query","required":false,"schema":{"type":"string","default":"us_aqi,european_aqi,pm10,pm2_5,ozone,nitrogen_dioxide"}},{"name":"hourly","in":"query","required":false,"schema":{"type":"string"}},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"auto"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":1800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:open-meteo/marine":{"get":{"operationId":"places_open_meteo_marine","summary":"Marine forecast","description":"Wave height, direction and period for ocean coordinates.","tags":["places"],"parameters":[{"name":"latitude","in":"query","required":true,"schema":{"type":"number"},"example":-8.72},{"name":"longitude","in":"query","required":true,"schema":{"type":"number"},"example":115.17},{"name":"current","in":"query","required":false,"schema":{"type":"string","default":"wave_height,wave_direction,wave_period"}},{"name":"daily","in":"query","required":false,"schema":{"type":"string","default":"wave_height_max"}},{"name":"timezone","in":"query","required":false,"schema":{"type":"string","default":"auto"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":1800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:open-meteo/geocode":{"get":{"operationId":"places_open_meteo_geocode","summary":"Geocoding","description":"Find coordinates, country and timezone for a place name.","tags":["places"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"},"example":"Lisbon"},{"name":"count","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":5,"minimum":1,"maximum":100,"description":"Number of results"}},{"name":"language","in":"query","required":false,"schema":{"type":"string","default":"en"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:nominatim/search":{"get":{"operationId":"places_nominatim_search","summary":"Search","description":"Turn an address or place name into coordinates.","tags":["places"],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"example":"Brandenburger Tor, Berlin"},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":5,"minimum":1,"maximum":40,"description":"Number of results"}},{"name":"countryCodes","in":"query","required":false,"description":"Comma-separated ISO 3166-1 alpha-2 codes","schema":{"type":"string","description":"Comma-separated ISO 3166-1 alpha-2 codes"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:nominatim/reverse":{"get":{"operationId":"places_nominatim_reverse","summary":"Reverse","description":"Turn coordinates into an address.","tags":["places"],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"},"example":51.5007},{"name":"lon","in":"query","required":true,"schema":{"type":"number"},"example":-0.1246},{"name":"zoom","in":"query","required":false,"schema":{"type":"integer","default":18,"minimum":3,"maximum":18}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:zippopotam/lookup":{"get":{"operationId":"places_zippopotam_lookup","summary":"Postal code","description":"Places for one postal code.","tags":["places"],"parameters":[{"name":"country","in":"query","required":true,"description":"ISO 3166-1 alpha-2","schema":{"type":"string","description":"ISO 3166-1 alpha-2"},"example":"us"},{"name":"postalCode","in":"query","required":true,"schema":{"type":"string"},"example":"90210"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:rest-countries/by-name":{"get":{"operationId":"places_rest_countries_by_name","summary":"By name","description":"Countries matching a name.","tags":["places"],"parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"},"example":"japan"},{"name":"fields","in":"query","required":false,"description":"Comma-separated fields to return","schema":{"type":"string","description":"Comma-separated fields to return"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:rest-countries/by-code":{"get":{"operationId":"places_rest_countries_by_code","summary":"By code","description":"Country by ISO 3166 alpha-2 or alpha-3 code.","tags":["places"],"parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string"},"example":"BR"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:rest-countries/by-region":{"get":{"operationId":"places_rest_countries_by_region","summary":"By region","description":"Countries in a region.","tags":["places"],"parameters":[{"name":"region","in":"query","required":true,"schema":{"type":"string","enum":["africa","americas","asia","europe","oceania"]},"example":"europe"},{"name":"fields","in":"query","required":false,"schema":{"type":"string","default":"name,cca2,capital,population,flags"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:rest-countries/by-currency":{"get":{"operationId":"places_rest_countries_by_currency","summary":"By currency","description":"Countries using a currency.","tags":["places"],"parameters":[{"name":"currency","in":"query","required":true,"schema":{"type":"string"},"example":"eur"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:sunrise-sunset/times":{"get":{"operationId":"places_sunrise_sunset_times","summary":"Sun times","description":"Times in UTC (ISO 8601).","tags":["places"],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"},"example":35.6762},{"name":"lng","in":"query","required":true,"schema":{"type":"number"},"example":139.6503},{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD, default today","schema":{"type":"string","description":"YYYY-MM-DD, default today"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:us-weather-service/point":{"get":{"operationId":"places_us_weather_service_point","summary":"Point metadata","description":"Forecast office and forecast URLs for a US coordinate.","tags":["places"],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"},"example":39.7456},{"name":"lon","in":"query","required":true,"schema":{"type":"number"},"example":-97.0892}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:us-weather-service/forecast":{"get":{"operationId":"places_us_weather_service_forecast","summary":"Forecast","description":"7-day forecast for a forecast office grid point.","tags":["places"],"parameters":[{"name":"office","in":"query","required":true,"schema":{"type":"string"},"example":"TOP"},{"name":"gridX","in":"query","required":true,"schema":{"type":"integer"},"example":31},{"name":"gridY","in":"query","required":true,"schema":{"type":"integer"},"example":80}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":1800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:us-weather-service/alerts":{"get":{"operationId":"places_us_weather_service_alerts","summary":"Active alerts","description":"Active watches, warnings and advisories.","tags":["places"],"parameters":[{"name":"area","in":"query","required":false,"description":"US state or marine area code","schema":{"type":"string","description":"US state or marine area code"},"example":"CA"},{"name":"severity","in":"query","required":false,"schema":{"type":"string","enum":["Extreme","Severe","Moderate","Minor","Unknown"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":300,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:usgs-earthquakes/feed":{"get":{"operationId":"places_usgs_earthquakes_feed","summary":"Live feed","description":"Summary feed as GeoJSON.","tags":["places"],"parameters":[{"name":"magnitude","in":"query","required":false,"schema":{"type":"string","enum":["significant","4.5","2.5","1.0","all"],"default":"4.5"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","enum":["hour","day","week","month"],"default":"day"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":120,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:usgs-earthquakes/search":{"get":{"operationId":"places_usgs_earthquakes_search","summary":"Search","description":"Earthquakes by time window, magnitude and area.","tags":["places"],"parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string"},"example":"2024-01-01"},{"name":"end","in":"query","required":false,"schema":{"type":"string"}},{"name":"minMagnitude","in":"query","required":false,"schema":{"type":"number","default":4}},{"name":"latitude","in":"query","required":false,"schema":{"type":"number"}},{"name":"longitude","in":"query","required":false,"schema":{"type":"number"}},{"name":"maxRadiusKm","in":"query","required":false,"schema":{"type":"number","maximum":20001.6}},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":50,"minimum":1,"maximum":2000,"description":"Number of results"}},{"name":"orderBy","in":"query","required":false,"schema":{"type":"string","enum":["time","time-asc","magnitude","magnitude-asc"],"default":"time"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":300,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:public-holidays/by-country":{"get":{"operationId":"places_public_holidays_by_country","summary":"Holidays by country","description":"All public holidays in a year.","tags":["places"],"parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"integer"},"example":2026},{"name":"countryCode","in":"query","required":true,"schema":{"type":"string"},"example":"DE"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:public-holidays/next":{"get":{"operationId":"places_public_holidays_next","summary":"Next holidays","description":"Upcoming holidays in one country.","tags":["places"],"parameters":[{"name":"countryCode","in":"query","required":true,"schema":{"type":"string"},"example":"US"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:public-holidays/worldwide":{"get":{"operationId":"places_public_holidays_worldwide","summary":"Next 7 days worldwide","description":"Holidays in the next seven days anywhere.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:public-holidays/long-weekends":{"get":{"operationId":"places_public_holidays_long_weekends","summary":"Long weekends","description":"Long weekends in a year.","tags":["places"],"parameters":[{"name":"year","in":"query","required":true,"schema":{"type":"integer"},"example":2026},{"name":"countryCode","in":"query","required":true,"schema":{"type":"string"},"example":"GB"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:public-holidays/countries":{"get":{"operationId":"places_public_holidays_countries","summary":"Supported countries","description":"Countries with holiday data.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:met-norway/forecast":{"get":{"operationId":"places_met_norway_forecast","summary":"Forecast","description":"Compact location forecast.","tags":["places"],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"},"example":59.91},{"name":"lon","in":"query","required":true,"schema":{"type":"number"},"example":10.75}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":1800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:7timer/forecast":{"get":{"operationId":"places_7timer_forecast","summary":"Forecast","description":"Forecast product for a coordinate.","tags":["places"],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"},"example":23.09},{"name":"lon","in":"query","required":true,"schema":{"type":"number"},"example":113.17},{"name":"product","in":"query","required":false,"schema":{"type":"string","enum":["civil","civillight","astro","two"],"default":"civillight"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:prayer-times/by-city":{"get":{"operationId":"places_prayer_times_by_city","summary":"By city","description":"Today's timings for a city.","tags":["places"],"parameters":[{"name":"city","in":"query","required":true,"schema":{"type":"string"},"example":"London"},{"name":"country","in":"query","required":true,"schema":{"type":"string"},"example":"United Kingdom"},{"name":"method","in":"query","required":false,"description":"Calculation method id (default by country)","schema":{"type":"integer","description":"Calculation method id (default by country)"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:prayer-times/by-coordinates":{"get":{"operationId":"places_prayer_times_by_coordinates","summary":"By coordinates","description":"Timings for a coordinate and date.","tags":["places"],"parameters":[{"name":"latitude","in":"query","required":true,"schema":{"type":"number"},"example":21.4225},{"name":"longitude","in":"query","required":true,"schema":{"type":"number"},"example":39.8262},{"name":"date","in":"query","required":false,"description":"DD-MM-YYYY, default today","schema":{"type":"string","description":"DD-MM-YYYY, default today"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:hebcal/holidays":{"get":{"operationId":"places_hebcal_holidays","summary":"Holidays","description":"Major holidays for a year.","tags":["places"],"parameters":[{"name":"year","in":"query","required":false,"schema":{"type":"string","default":"now"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:hebcal/shabbat":{"get":{"operationId":"places_hebcal_shabbat","summary":"Shabbat times","description":"Candle lighting and Havdalah for a GeoNames id.","tags":["places"],"parameters":[{"name":"geonameid","in":"query","required":true,"schema":{"type":"string"},"example":"281184"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:india-pincode/pincode":{"get":{"operationId":"places_india_pincode_pincode","summary":"PIN code","description":"Post offices for a PIN.","tags":["places"],"parameters":[{"name":"pincode","in":"query","required":true,"schema":{"type":"string"},"example":"110001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:japan-postcode/lookup":{"get":{"operationId":"places_japan_postcode_lookup","summary":"Lookup","description":"Address for a 7-digit code.","tags":["places"],"parameters":[{"name":"zipcode","in":"query","required":true,"schema":{"type":"string"},"example":"1000001"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:overpass/nearby":{"get":{"operationId":"places_overpass_nearby","summary":"Places nearby","description":"OSM nodes and ways with a given tag within a radius (meters) of a point.","tags":["places"],"parameters":[{"name":"key","in":"query","required":true,"description":"OSM tag key, e.g. amenity, shop, tourism, healthcare","schema":{"type":"string","description":"OSM tag key, e.g. amenity, shop, tourism, healthcare"},"example":"amenity"},{"name":"value","in":"query","required":true,"description":"OSM tag value, e.g. dentist, cafe, hospital, atm, supermarket","schema":{"type":"string","description":"OSM tag value, e.g. dentist, cafe, hospital, atm, supermarket"},"example":"dentist"},{"name":"lat","in":"query","required":true,"schema":{"type":"number"},"example":-6.2088},{"name":"lon","in":"query","required":true,"schema":{"type":"number"},"example":106.8456},{"name":"radius","in":"query","required":false,"description":"Meters","schema":{"type":"integer","default":2000,"minimum":50,"maximum":20000,"description":"Meters"}},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":50,"minimum":1,"maximum":200,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:photon/search":{"get":{"operationId":"places_photon_search","summary":"Search places","description":"Forward geocoding with optional location bias.","tags":["places"],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"Brandenburg Gate"},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":5,"minimum":1,"maximum":50,"description":"Number of results"}},{"name":"lat","in":"query","required":false,"schema":{"type":"number"}},{"name":"lon","in":"query","required":false,"schema":{"type":"number"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","enum":["default","en","de","fr","it"],"default":"default"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:photon/reverse":{"get":{"operationId":"places_photon_reverse","summary":"Reverse geocode","description":"Address and place for a coordinate.","tags":["places"],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"},"example":52.5163},{"name":"lon","in":"query","required":true,"schema":{"type":"number"},"example":13.3777}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:opentopodata/elevation":{"get":{"operationId":"places_opentopodata_elevation","summary":"Elevation","description":"Elevation in meters for one or more 'lat,lon' pairs separated by '|'.","tags":["places"],"parameters":[{"name":"locations","in":"query","required":true,"description":"lat,lon|lat,lon (max 100)","schema":{"type":"string","description":"lat,lon|lat,lon (max 100)"},"example":"-6.2,106.8|-7.94,112.95"},{"name":"dataset","in":"query","required":false,"schema":{"type":"string","enum":["srtm90m","srtm30m","aster30m","eudem25m","mapzen"],"default":"srtm90m"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:postcodes-io/lookup":{"get":{"operationId":"places_postcodes_io_lookup","summary":"Look up a postcode","description":"Location and administrative areas for a UK postcode.","tags":["places"],"parameters":[{"name":"postcode","in":"query","required":true,"schema":{"type":"string"},"example":"SW1A 1AA"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:postcodes-io/validate":{"get":{"operationId":"places_postcodes_io_validate","summary":"Validate a postcode","description":"Whether a UK postcode exists.","tags":["places"],"parameters":[{"name":"postcode","in":"query","required":true,"schema":{"type":"string"},"example":"SW1A 1AA"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:postcodes-io/reverse":{"get":{"operationId":"places_postcodes_io_reverse","summary":"Nearest postcodes","description":"Postcodes nearest to a coordinate.","tags":["places"],"parameters":[{"name":"lat","in":"query","required":true,"schema":{"type":"number"},"example":51.501},{"name":"lon","in":"query","required":true,"schema":{"type":"number"},"example":-0.1416},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:postcodes-io/autocomplete":{"get":{"operationId":"places_postcodes_io_autocomplete","summary":"Autocomplete","description":"Postcodes starting with a partial input.","tags":["places"],"parameters":[{"name":"partial","in":"query","required":true,"schema":{"type":"string"},"example":"SW1A"},{"name":"limit","in":"query","required":false,"description":"Number of results","schema":{"type":"integer","default":10,"minimum":1,"maximum":100,"description":"Number of results"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":86400,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:countriesnow/capitals":{"get":{"operationId":"places_countriesnow_capitals","summary":"Capitals","description":"Every country with its capital.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:countriesnow/currencies":{"get":{"operationId":"places_countriesnow_currencies","summary":"Currencies","description":"Every country with its currency.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:countriesnow/flags":{"get":{"operationId":"places_countriesnow_flags","summary":"Flags","description":"Flag image URLs for every country.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:countriesnow/population":{"get":{"operationId":"places_countriesnow_population","summary":"Population","description":"Historical population for every country.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:countriesnow/states":{"get":{"operationId":"places_countriesnow_states","summary":"States","description":"States/provinces for every country.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":604800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:gdacs/events":{"get":{"operationId":"places_gdacs_events","summary":"Current events","description":"Events filtered by type and alert level (GeoJSON).","tags":["places"],"parameters":[{"name":"types","in":"query","required":false,"description":"Semicolon list: EQ earthquake, TC cyclone, FL flood, VO volcano, DR drought, WF wildfire","schema":{"type":"string","default":"EQ;TC;FL;VO;DR;WF","description":"Semicolon list: EQ earthquake, TC cyclone, FL flood, VO volcano, DR drought, WF wildfire"}},{"name":"alertLevel","in":"query","required":false,"description":"Semicolon list of Green, Orange, Red","schema":{"type":"string","default":"Green;Orange;Red","description":"Semicolon list of Green, Orange, Red"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:space-weather/kp-index":{"get":{"operationId":"places_space_weather_kp_index","summary":"Planetary K-index","description":"Observed planetary K-index (geomagnetic activity), 3-hourly.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:space-weather/kp-forecast":{"get":{"operationId":"places_space_weather_kp_forecast","summary":"K-index forecast","description":"Predicted planetary K-index for the next days.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":1800,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:space-weather/alerts":{"get":{"operationId":"places_space_weather_alerts","summary":"Alerts","description":"Recent space weather alerts, watches and warnings.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:space-weather/solar-wind":{"get":{"operationId":"places_space_weather_solar_wind","summary":"Solar wind plasma","description":"Real-time solar wind plasma (density, speed, temperature), last 7 days.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:usgs-volcanoes/elevated":{"get":{"operationId":"places_usgs_volcanoes_elevated","summary":"Elevated volcanoes","description":"Volcanoes currently above normal alert level.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":900,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/places:usgs-volcanoes/monitored":{"get":{"operationId":"places_usgs_volcanoes_monitored","summary":"Monitored volcanoes","description":"All monitored US volcanoes with their current status.","tags":["places"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":3600,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"dev-tools:hash"},"data":{},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}