Launching a weather API
Weather is a big part of daily news. No matter how one chooses to navigate daily life, knowing the weather ahead of time makes things easier. A hot day? Drink plenty of fluids and stay in the shade. A passing rain shower? Take an umbrella. A snowstorm approaching? Get off the roads before it hits. This is why local news can never be complete without a local weather forecast.
Today, we are happy to announce that we are launching a weather API. Now you can get the latest weather forecast for your location, no matter where you are in the world. Make the most of the your day with accurate weather forecasts and timely alerts for severe weather.
Weather API
The Newshound weather API would be familiar to those who have used the Dark Sky API in the past.
Sign up here for our private beta and get an API Key.
API Request
The Newshound Weather API is based on the REST API architecture. A request needs to made with an API key and the location's latitude and longitude.
curl --request GET
--url 'https://api.newshound.co/v1/weather/forecast/API_KEY/LAT,LONG'
--header 'accept: application/json'
Here is an example for the city of Mountain View, California (latitude 37.4175°N and longitude -122.0704°W).
curl --request GET
--url 'https://api.newshound.co/v1/weather/forecast/API_KEY/37.4175,-122.0704'
--header 'accept: application/json'
API Response
The Newshound Weather API response is in JSON format. Here is a real example for the city of Mountain View, California on a rainy day when severe weather was forecast for the region.
{
"latitude": 37.4054323,
"longitude": -122.079172,
"timezone": "America/Los_Angeles",
"currently": {
"time": 1597575633,
"summary": "Drizzle",
"icon": "rain",
"nearestStormDistance": 0,
"precipIntensity": 0.0078,
"precipIntensityError": 0.0036,
"precipProbability": 0.97,
"precipType": "rain",
"temperature": 76.77,
"apparentTemperature": 76.77,
"dewPoint": 56.7,
"humidity": 0.5,
"pressure": 1012.4,
"windSpeed": 3.58,
"windGust": 9.58,
"windBearing": 169,
"cloudCover": 0.57,
"uvIndex": 0,
"visibility": 10,
"ozone": 284.3
},
"alerts": [
{
"title": "Severe Thunderstorm Warning",
"regions": [
"Alameda",
"Monterey",
"San Benito",
"San Francisco",
"San Mateo",
"Santa Clara",
"Santa Cruz"
],
"severity": "warning",
"time": 1597574580,
"expires": 1597576500,
"description": "...A SEVERE THUNDERSTORM WARNING REMAINS IN EFFECT UNTIL 415 AM PDT FOR ALAMEDA...SAN MATEO...SANTA CRUZ...SAN FRANCISCO...NORTHWESTERN SAN BENITO...SANTA CLARA AND WESTERN MONTEREY COUNTIES... At 342 AM PDT, severe thunderstorms were located along a line extending from 31 miles southwest of Point Reyes Station to 17 miles southwest of Patterson, moving north at 55 mph. HAZARD...Erratic outflow wind gusts up to 60mph. Frequent lightning. SOURCE...Public and Doppler Radar. IMPACT...Expect damage to roofs, siding, and trees. Wildfires may start in remote areas due to the lightning. Locations impacted include... San Jose, San Francisco, Oakland, Fremont, Salinas, Hayward, Sunnyvale, Santa Clara, Daly City, San Mateo, San Leandro, Livermore, Redwood City, Mountain View, Alameda, San Ramon, Pleasanton, Union City, Milpitas and Palo Alto. HAIL...<.75IN WIND...60MPH\n",
"uri": "https://alerts.weather.gov/cap/wwacapget.php?x=CA125F5E77D36C.SevereThunderstormWarning.125F5E77EF8CCA.MTRSVSMTR.ccbb97f344cb9317d9cd3aa9a614e618"
},
{
"title": "Severe Thunderstorm Warning",
"regions": [
"Alameda",
"Contra Costa",
"Marin",
"Monterey",
"Napa",
"San Francisco",
"San Mateo",
"Santa Clara",
"Santa Cruz",
"Sonoma"
],
"severity": "warning",
"time": 1597575300,
"expires": 1597580100,
"description": "The National Weather Service in The San Francisco Bay Area has issued a * Severe Thunderstorm Warning for... Marin County in northern California... Alameda County in northern California... San Mateo County in northern California... Santa Cruz County in northern California... Eastern Sonoma County in northern California... Contra Costa County in northern California... San Francisco County in northern California... Santa Clara County in northern California... Northwestern Monterey County in central California... Napa County in northern California... * Until 515 AM PDT. * At 351 AM PDT, a line of training severe thunderstorms were located over the San Francisco Peninsula, Santa Cruz mountains, and Monterey Bay, moving north at 45 mph. HAZARD...Erratic gusty outflow winds up to 60mph. Frequent lightning which may lead to wildfire starts. SOURCE...Public. IMPACT...Expect damage to roofs, siding, and trees. Wildfire starts from the lightning. Power outages from the wind. * Locations impacted include... Entire San Francisco Bay Area, Santa Cruz Area, Monterey Bay coast. HAIL...<.75IN WIND...60MPH\n",
"uri": "https://alerts.weather.gov/cap/wwacapget.php?x=CA125F5E77D81C.SevereThunderstormWarning.125F5E78169CCA.MTRSVRMTR.be33d325771487d9dbf171f4285c89b4"
},
{
"title": "Severe Weather Statement",
"regions": [
"Alameda",
"Monterey",
"San Benito",
"San Francisco",
"San Mateo",
"Santa Clara",
"Santa Cruz"
],
"severity": "warning",
"time": 1597574580,
"expires": 1597576500,
"description": "...A SEVERE THUNDERSTORM WARNING REMAINS IN EFFECT UNTIL 415 AM PDT FOR ALAMEDA...SAN MATEO...SANTA CRUZ...SAN FRANCISCO...NORTHWESTERN SAN BENITO...SANTA CLARA AND WESTERN MONTEREY COUNTIES... At 342 AM PDT, severe thunderstorms were located along a line extending from 31 miles southwest of Point Reyes Station to 17 miles southwest of Patterson, moving north at 55 mph. HAZARD...Erratic outflow wind gusts up to 60mph. Frequent lightning. SOURCE...Public and Doppler Radar. IMPACT...Expect damage to roofs, siding, and trees. Wildfires may start in remote areas due to the lightning. Locations impacted include... San Jose, San Francisco, Oakland, Fremont, Salinas, Hayward, Sunnyvale, Santa Clara, Daly City, San Mateo, San Leandro, Livermore, Redwood City, Mountain View, Alameda, San Ramon, Pleasanton, Union City, Milpitas and Palo Alto. HAIL...<.75IN WIND...60MPH\n",
"uri": "https://alerts.weather.gov/cap/wwacapget.php?x=CA125F5E77D36C.SevereWeatherStatement.125F5E77EF8CCA.MTRSVSMTR.ee0c68d9f722315702234a17f9f6cf74"
},
{
"title": "Red Flag Warning",
"regions": [
"Coastal North Bay Including Point Reyes National Seashore",
"East Bay Hills and the Diablo Range",
"East Bay Interior Valleys",
"North Bay Interior Valleys",
"North Bay Mountains",
"Northern Monterey Bay",
"San Francisco",
"San Francisco Bay Shoreline",
"San Francisco Peninsula Coast",
"San Fransisco Peninsula Coast",
"Santa Clara Valley Including San Jose",
"Santa Cruz Mountains"
],
"severity": "warning",
"time": 1597568220,
"expires": 1597687200,
"description": "...RED FLAG WARNING NOW IN EFFECT UNTIL 11 AM PDT MONDAY... * AFFECTED AREA...The entire San Francisco Bay region including the Santa Cruz Mountains, the South Bay, East Bay Hills and North Bay. * THUNDERSTORMS...Thunderstorms are forecast to develop over the South Bay and Santa Cruz region overnight and then spread northward through Sunday. Not all locations will see thunderstorms but any lightning strikes will likely lead to new fire starts given the current heat wave. A secondary pulse of moisture and instability arrives later Sunday into early Monday. * WIND...Light wind except for breezy onshore winds in the afternoon near the coast. Locally gusty winds possible near any thunderstorms. * HUMIDITY... Recoveries tonight in the 30s to 50s across the interior and 60s to 90s alongshore. Minimum humidity mid 10s to mid 20s percent across the higher elevations and interior & 30 to 50 percent nearshore and lower elevation for Sunday. * IMPACTS...Increase in wildfire starts in proximity to thunderstorms due to lightning. Fires may spread rapidly due to dry fuels and, if nearshore, breezy onshore winds.\n",
"uri": "https://alerts.weather.gov/cap/wwacapget.php?x=CA125F5E778AC4.RedFlagWarning.125F5E883D60CA.MTRRFWMTR.f3762d35eab5a720255b78c324ec2674"
},
{
"title": "Heat Advisory",
"regions": [
"North Bay Interior Valleys",
"Northern Salinas Valley/Hollister Valley and Carmel Valley",
"San Francisco Bay Shoreline",
"Santa Cruz Mountains"
],
"severity": "advisory",
"time": 1597568400,
"expires": 1597636800,
"description": "...Extended Heat today through Wednesday across the San Francisco Bay Area and Central Coast... .A long duration heat wave will impact the region through at least Wednesday of next week, and possibly beyond. Excessive heat will target interior locations for the full duration of the heat event, with persistent daily afternoon highs in the upper 90s to mid 100s across the interior. Drastic temperature differences will exist from the coast to the interior and communities just a few to several miles inland may experience rapid warming into the upper 80s to 90s on individual days. In addition, minimal overnight relief is expected for locations above 500 feet where warm overnight lows will hover in the upper 60s to low 80s. Due to the long duration of this event, accumulating heat stress will be a significant impact for the general public, pets, vegetation, and livestock across the region, particularly those sensitive to the heat. Relatively cooler conditions are expected to persist near the immediate coast with highs in the 70s to 80s, though wind sheltered coastal areas could rise into the 90s or even locally 100 on the hottest days. ...HEAT ADVISORY REMAINS IN EFFECT UNTIL 9 PM PDT THIS EVENING... * WHAT...Warm overnight temperatures will provide little relief with low expected to drop into the 60s in the valleys and 70s in the hills. Peak temperatures in the the upper 80s to upper 90s near the coast, locally into the low 100s for areas more than 20 miles from the coast on Sunday. * WHERE...San Francisco Bay Shoreline, North Bay Interior Valleys, Santa Cruz Mountains and Northern Salinas Valley/Hollister Valley and Carmel Valley. * WHEN...Until 9 PM PDT Sunday. * IMPACTS...Elevated heat will increase the potential for heat related illnesses, particularly among vulnerable populations and those working outdoors or in areas without air conditioning. * ADDITIONAL DETAILS...Temperatures on Sunday will be slightly cooler than Saturday. Temperatures will increase once again early next week with a second peak in the heat anticipated to arrive Tuesday into Wednesday of next week. Additional heat advisories may be necessary during this time frame.\n",
"uri": "https://alerts.weather.gov/cap/wwacapget.php?x=CA125F5E779B90.HeatAdvisory.125F5E861A80CA.MTRNPWMTR.66e7f62f390e1d1de4e84902c3af6b68"
}
],
"flags": {
"sources": [
"noaa",
],
"nearest-station": 0,
"units": "us",
},
"offset": -7
}