# Weatherbit - Interactive Swagger UI Documentation API

> Weatherbit - Interactive Swagger UI Documentation API on Apizie: 47 endpoints (Returns severe weather alerts issued by meteorological agencies - Given a lat/lon., Download pre-generated bulk datasets, Returns current air quality conditions - Given City and/or State, Country., Returns current air quality conditions - Given a City ID., …) returned as clean JSON through one API key. 47 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/places:weatherbit/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `places:weatherbit`
- Category: Places
- Status: live
- Source: https://weatherbit.io
- Page: https://zieapi.vercel.app/api/places/weatherbit
- OpenAPI: https://zieapi.vercel.app/api/places/weatherbit/openapi.json

This an interactive version of the documentation for the Weatherbit API. The base URL for the API is [http://api.weatherbit.io/v2.0/](http://api.weatherbit.io/v2.0/) or…

## Endpoints

### Returns severe weather alerts issued by meteorological agencies - Given a lat/lon.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-alerts-lat-lat-lon-lon`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | yes | Latitude component of location. |
| lon | number | yes | Longitude component of location. |
| callback | string | no | Wraps return in jsonp callback - Example - callback=func |
| key | string | yes | Your registered API key. |

### Download pre-generated bulk datasets
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-bulk-files-file`

| Parameter | Type | Required | Description |
|---|---|---|---|
| file | string | yes | Filename (ie. current.csv.gz) |
| key | string | yes | Your registered API key. |

### Returns current air quality conditions - Given City and/or State, Country.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-current-airquality-city-city-country-country`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city | string | yes | City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR |
| state | string | no | Full name of state. |
| country | string | yes | Country Code (2 letter). |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns current air quality conditions - Given a City ID.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-current-airquality-city-id-city-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city_id | integer | yes | City ID. Example: 4487042 |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| key | string | yes | Your registered API key. |

### Returns current air quality conditions - Given a lat/lon.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-current-airquality-lat-lat-lon-lon`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | yes | Latitude component of location. |
| lon | number | yes | Longitude component of location. |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| key | string | yes | Your registered API key. |

### Returns current air quality conditions - Given a Postal Code.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-current-airquality-postal-code-postal-code`

| Parameter | Type | Required | Description |
|---|---|---|---|
| postal_code | integer | yes | Postal Code. Example: 28546 |
| country | string | no | Country Code (2 letter). |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| key | string | yes | Your registered API key. |

### Returns a group of observations given a list of cities
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-current-cities-cities`

| Parameter | Type | Required | Description |
|---|---|---|---|
| cities | string | yes | Comma separated list of City ID's. Example: 4487042, 4494942, 4504871 |
| units | string | no | Convert to units. Default Metric See units field description |
| marine | string | no | Marine stations only (buoys, oil platforms, etc) |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback - Example - callback=func |
| key | string | yes | Your registered API key. |

### Returns a Current Observation - Given City and/or State, Country.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-current-city-city-country-country`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city | string | yes | City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR |
| include | string | no | Include 1 hour - minutely forecast in the response |
| state | string | no | Full name of state. |
| country | string | yes | Country Code (2 letter). |
| marine | string | no | Marine stations only (buoys, oil platforms, etc) |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback - Example - callback=func |
| key | string | yes | Your registered API key. |

### Returns a current observation by city id.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-current-city-id-city-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city_id | string | yes | City ID. Example: 4487042 |
| units | string | no | Convert to units. Default Metric See units field description |
| include | string | no | Include 1 hour - minutely forecast in the response |
| marine | string | no | Marine stations only (buoys, oil platforms, etc) |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback - Example - callback=func |
| key | string | yes | Your registered API key. |

### Returns a Current Observation - Given a lat/lon.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-current-lat-lat-lon-lon`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | yes | Latitude component of location. |
| lon | number | yes | Longitude component of location. |
| include | string | no | Include 1 hour - minutely forecast in the response |
| marine | string | no | Marine stations only (buoys, oil platforms, etc) |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback - Example - callback=func |
| key | string | yes | Your registered API key. |

### Returns a group of observations given a list of points in the format (lat1, lon1), (lat2, lon2), (latN,…
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-current-points-points`

| Parameter | Type | Required | Description |
|---|---|---|---|
| points | string | yes | Comma separated list of points. Example: (35.5, -75.5),(45, 65),(45.12, -130.5) |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns a current observation by postal code.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-current-postal-code-postal-code`

| Parameter | Type | Required | Description |
|---|---|---|---|
| postal_code | string | yes | Postal Code. Example: 28546 |
| country | string | no | Country Code (2 letter). |
| include | string | no | Include 1 hour - minutely forecast in the response |
| marine | string | no | Marine stations only (buoys, oil platforms, etc) |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback - Example - callback=func |
| key | string | yes | Your registered API key. |

### Returns a Current Observation. - Given a station ID.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-current-station-station`

| Parameter | Type | Required | Description |
|---|---|---|---|
| station | string | yes | Station Call ID. |
| include | string | no | Include 1 hour - minutely forecast in the response |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns a group of observations given a list of stations
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-current-stations-stations`

| Parameter | Type | Required | Description |
|---|---|---|---|
| stations | string | yes | Comma separated list of Station Call ID's. Example: KRDU,KBFI,KVNY |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns 72 hour (hourly) Air Quality forecast - Given City and/or State, Country.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-airquality-city-city-country-country`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city | string | yes | City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR |
| state | string | no | Full name of state. |
| country | string | yes | Country Code (2 letter). |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| hours | integer | no | Number of hours to return. |
| key | string | yes | Your registered API key. |

### Returns 72 hour (hourly) Air Quality forecast - Given a City ID.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-airquality-city-id-city-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city_id | integer | yes | City ID. Example: 4487042 |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| hours | integer | no | Number of hours to return. |
| key | string | yes | Your registered API key. |

### Returns 72 hour (hourly) Air Quality forecast - Given a lat/lon.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-airquality-lat-lat-lon-lon`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | yes | Latitude component of location. |
| lon | number | yes | Longitude component of location. |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| key | string | yes | Your registered API key. |
| hours | integer | no | Number of hours to return. |

### Returns 72 hour (hourly) Air Quality forecast - Given a Postal Code.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-airquality-postal-code-postal-code`

| Parameter | Type | Required | Description |
|---|---|---|---|
| postal_code | integer | yes | Postal Code. Example: 28546 |
| country | string | no | Country Code (2 letter). |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| hours | integer | no | Number of hours to return. |
| key | string | yes | Your registered API key. |

### Returns a daily forecast - Given City and/or State, Country.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-daily-city-city-country-country`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city | string | yes | City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR |
| state | string | no | Full name of state. |
| country | string | yes | Country Code (2 letter). |
| days | number | no | Number of days to return. Default 16. |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| key | string | yes | Your registered API key. |

### Returns a daily forecast - Given a City ID.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-daily-city-id-city-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city_id | integer | yes | City ID. Example: 4487042 |
| days | number | no | Number of days to return. Default 16. |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns a daily forecast - Given Lat/Lon.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-daily-lat-lat-lon-lon`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | yes | Latitude component of location. |
| lon | number | yes | Longitude component of location. |
| days | number | no | Number of days to return. Default 16. |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns a daily forecast - Given a Postal Code.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-daily-postal-code-postal-code`

| Parameter | Type | Required | Description |
|---|---|---|---|
| postal_code | integer | yes | Postal Code. Example: 28546 |
| country | string | no | Country Code (2 letter). |
| days | number | no | Number of days to return. Default 16. |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Energy Forecast API response - Given a single lat/lon.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-energy-lat-lat-lon-lon`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | yes | Latitude component of location. |
| lon | number | yes | Longitude component of location. |
| threshold | number | no | Temperature threshold to use to calculate degree days (default 18 C) |
| units | string | no | Convert to units. Default Metric See units field description |
| tp | string | no | Time period (default: daily) |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns an hourly forecast - Given City and/or State, Country.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-hourly-city-city-country-country`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city | string | yes | City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR |
| state | string | no | Full name of state. |
| country | string | yes | Country Code (2 letter). |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| hours | integer | no | Number of hours to return. |
| key | string | yes | Your registered API key. |

### Returns an hourly forecast - Given a City ID.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-hourly-city-id-city-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city_id | integer | yes | City ID. Example: 4487042 |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| hours | integer | no | Number of hours to return. |
| key | string | yes | Your registered API key. |

### Returns an hourly forecast - Given a lat/lon.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-hourly-lat-lat-lon-lon`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | yes | Latitude component of location. |
| lon | number | yes | Longitude component of location. |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| key | string | yes | Your registered API key. |
| hours | integer | no | Number of hours to return. |

### Returns an hourly forecast - Given a Postal Code.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-forecast-hourly-postal-code-postal-code`

| Parameter | Type | Required | Description |
|---|---|---|---|
| postal_code | integer | yes | Postal Code. Example: 28546 |
| country | string | no | Country Code (2 letter). |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| hours | integer | no | Number of hours to return. |
| key | string | yes | Your registered API key. |

### Returns 72 hours of historical quality conditions - Given City and/or State, Country.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-airquality-city-city-country-country`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city | string | yes | City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR |
| state | string | no | Full name of state. |
| country | string | yes | Country Code (2 letter). |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns 72 hours of historical air quality conditions - Given a City ID.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-airquality-city-id-city-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city_id | number | yes | City ID. |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| key | string | yes | Your registered API key. |

### Returns 72 hours of historical air quality conditions - Given a lat/lon.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-airquality-lat-lat-lon-lon`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | yes | Latitude component of location. |
| lon | number | yes | Longitude component of location. |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| key | string | yes | Your registered API key. |

### Returns 72 hours of historical air quality conditions - Given a Postal Code.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-airquality-postal-code-postal-code`

| Parameter | Type | Required | Description |
|---|---|---|---|
| postal_code | integer | yes | Postal Code. Example: 28546 |
| country | string | no | Country Code (2 letter). |
| callback | string | no | Wraps return in jsonp callback. Example - callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given City and/or State, Country.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-daily-city-city-country-country`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city | string | yes | City search.. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR |
| state | string | no | Full name of state. |
| country | string | yes | Country Code (2 letter). |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given a City ID
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-daily-city-id-city-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city_id | string | yes | City ID. Example: 4487042 |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH) |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH) |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given a lat/lon.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-daily-lat-lat-lon-lon`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | yes | Latitude component of location. |
| lon | number | yes | Longitude component of location. |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given a Postal Code
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-daily-postal-code-postal-code`

| Parameter | Type | Required | Description |
|---|---|---|---|
| postal_code | string | yes | Postal Code. Example: 28546 |
| country | string | no | Country Code (2 letter). |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH) |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH) |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given a station ID.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-daily-station-station`

| Parameter | Type | Required | Description |
|---|---|---|---|
| station | string | yes | Station ID. |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Energy API response - Given a single lat/lon.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-energy-lat-lat-lon-lon`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | yes | Latitude component of location. |
| lon | number | yes | Longitude component of location. |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| tp | string | no | Time period to aggregate by (daily, monthly) |
| threshold | number | no | Temperature threshold to use to calculate degree days (default 18 C) |
| units | string | no | Convert to units. Default Metric See units field description |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given City and/or State, Country.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-hourly-city-city-country-country`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city | string | yes | City search. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR |
| state | string | no | Full name of state. |
| country | string | yes | Country Code (2 letter). |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| tz | string | no | Assume utc (default) or local time for start_date, end_date |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given a City ID
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-hourly-city-id-city-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city_id | string | yes | City ID. Example: 4487042 |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH) |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH) |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| tz | string | no | Assume utc (default) or local time for start_date, end_date |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given a lat/lon.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-hourly-lat-lat-lon-lon`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | yes | Latitude component of location. |
| lon | number | yes | Longitude component of location. |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| tz | string | no | Assume utc (default) or local time for start_date, end_date |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given a Postal Code
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-hourly-postal-code-postal-code`

| Parameter | Type | Required | Description |
|---|---|---|---|
| postal_code | string | yes | Postal Code. Example: 28546 |
| country | string | no | Country Code (2 letter). |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH) |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH) |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| tz | string | no | Assume utc (default) or local time for start_date, end_date |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given a station ID.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-hourly-station-station`

| Parameter | Type | Required | Description |
|---|---|---|---|
| station | string | yes | Station ID. |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| tz | string | no | Assume utc (default) or local time for start_date, end_date |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given City and/or State, Country.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-subhourly-city-city-country-country`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city | string | yes | City search. Example - &city=Raleigh,NC or &city=Berlin,DE or city=Paris&country=FR |
| state | string | no | Full name of state. |
| country | string | yes | Country Code (2 letter). |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| tz | string | no | Assume utc (default) or local time for start_date, end_date |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given a City ID
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-subhourly-city-id-city-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| city_id | string | yes | City ID. Example: 4487042 |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH) |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH) |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| tz | string | no | Assume utc (default) or local time for start_date, end_date |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given a lat/lon.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-subhourly-lat-lat-lon-lon`

| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | yes | Latitude component of location. |
| lon | number | yes | Longitude component of location. |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| tz | string | no | Assume utc (default) or local time for start_date, end_date |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given a Postal Code
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-subhourly-postal-code-postal-code`

| Parameter | Type | Required | Description |
|---|---|---|---|
| postal_code | string | yes | Postal Code. Example: 28546 |
| country | string | no | Country Code (2 letter). |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH) |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH) |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| tz | string | no | Assume utc (default) or local time for start_date, end_date |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

### Returns Historical Observations - Given a station ID.
`GET https://zieapi.vercel.app/v1/places:weatherbit/get-history-subhourly-station-station`

| Parameter | Type | Required | Description |
|---|---|---|---|
| station | string | yes | Station ID. |
| start_date | string | yes | Start Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| end_date | string | yes | End Date (YYYY-MM-DD or YYYY-MM-DD:HH). |
| units | string | no | Convert to units. Default Metric See units field description |
| lang | string | no | Language (Default: English) See language field description |
| tz | string | no | Assume utc (default) or local time for start_date, end_date |
| callback | string | no | Wraps return in jsonp callback. Example: callback=func |
| key | string | yes | Your registered API key. |

## Example
```
curl "https://zieapi.vercel.app/v1/places:weatherbit/get-alerts-lat-lat-lon-lon" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Weatherbit - Interactive Swagger UI Documentation API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/places:weatherbit/get-alerts-lat-lat-lon-lon with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Weatherbit - Interactive Swagger UI Documentation API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Weatherbit - Interactive Swagger UI Documentation API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key places:weatherbit.

### What is the status of the Weatherbit - Interactive Swagger UI Documentation API?
Live: works with just an Apizie key