IoTuesday: Using Yahoo's Weather API

I'll show you how to use Yahoo's free Weather API.

Favorited Favorite 0

Using current weather or forecast data to change a display or provide information to a user in a seamless fashion seems to be popular among IoT projects. I know I'm guilty of it, because, well, they're nifty.

Most of these rely on API calls to OpenWeatherMap or Weather Underground (Wunderground), and both are great. OpenWeatherMap allows users to build their own weather stations and push data to their servers to be accessed by anyone. Wunderground is owned by The Weather Company and also lets users connect weather stations and contribute to weather/forecast data.

The one downside to pulling data from those two is that you are forced to create an account and use API keys. While I recommend using OpenWeatherMap or Wunderground for most of your needs (they support citizen science contributions!), if you need to obtain weather information without API keys (e.g., classroom), then another alternative exists: Yahoo Weather API.

There are limitations on its use, like noncommercial and 2,000 calls per day, but it still works well for an open API to get weather information. If you click on the link below, you can check out how to craft HTTP calls to the API:

It relies on a query language called "Yahoo Query Language (YQL)" that works similarly to SQL. If I enter the following into the query box, I can get a 10-day forecast for Boulder:

select item.forecast from weather.forecast where woeid in (select woeid from geo.places(1) where text="boulder, co")

The Endpoint also changes (see screenshot), which gives me an HTTP GET request that I can just paste into my code. Note that you might have to click "Test" a few times to get the correct response to show up instead of a "results": null. The YQL test page seems to be slow as of late.

Yahoo Weather API

Yahoo's Weather API seems to pull its information from, which is owned by The Weather Channel, so it's a fairly reliable source.

It would seem that the Yahoo Weather API was originally intended for website-embedded content, but we're going to use it for a different kind of embedded content: microcontrollers!

For this demo, you'll just need a SparkFun ESP8266 Thing Dev Board. Follow the hookup guide to install the Arduino library and copy in the following code (changing ssid and password to your WiFi's SSID and password, respectively):

#include <ESP8266WiFi.h>

// WiFi config
const char ssid[] = "<SSID>";
const char password[] = "<PASSWORD>";

// Server, file, port
const char hostname[] = "";
const String url = "/v1/public/yql?q=select%20item.condition.temp%20from%20weather.forecast%20where%20woeid%20in%20(select%20woeid%20from%20geo.places(1)%20where%20text%3D%22boulder%2C%20co%22)&format=json&";
const int port = 80;

// Timeout
unsigned long timeout = 10000;  // ms

// WiFi Client
WiFiClient client;

void setup() {

  // Init Serial

  // Connect to WiFi
  Serial.print("Connecting to ");
  WiFi.begin(ssid, password);
  while ( WiFi.status() != WL_CONNECTED ) {

  // Show we are connected

void loop() {

  unsigned long timestamp;
  int temp;

  // Establish TCP connection
  Serial.print("Connecting to ");
  if ( !client.connect(hostname, port) ) {
    Serial.println("Connection failed");

  // Send GET request
  String req = "GET " + url + " HTTP/1.1\r\n" + 
                "Host: " + hostname + "\r\n" +
                "Connection: close\r\n" +

  // Wait for response from server
  timestamp = millis();
  while ( !client.available() && (millis() < timestamp + timeout) ) {

  // Parse temperature
  if ( client.find("temp\":") ) {
    temp = client.parseInt();
    Serial.print("Local temperature: ");
    Serial.println(" F");

  // Flush receive buffer
  while ( client.available() ) {

  // Close TCP connection
  Serial.println("Connection closed");


You can change the URL to whatever you'd like from the Yahoo Weather API page in order to, for example, find the temperature in a different city. Here, I'm fetching the current temperature in Boulder, CO. Open a Serial monitor to get the parsed temperature:

Fetching local weather from Yahoo Weather API

What other cool weather-based projects have you seen or would you like to do? Please share your thoughts in the comments below.

Comments 9 comments

  • Member #1054204 / about 7 years ago / 1

    Hi Can i integrate the API in the app Showbox apk . Answer will be appriciated. Thank you

    • I don't know much about Showbox, but if you are actively developing it, I'm sure you could. You just need to be able to make REST HTTP requests and parse the response.

  • floppystick6 / about 7 years ago / 1

    One weather related project that I have been contemplating for a while, is to make a small device that will tell me to what my outer layer should be for the day (coat, jacket, rain coat, short sleeves). Currently, almost every morning, I stand by my coat closet and have to pull out my phone, unlock it, navigate to my weather app, and wait for it to refresh its data. Which takes way to much time just to figure out which coat/jacket I should wear for the day. I was thinking about just using a button or a PIR mortion sensor to trigger it to update, and then use an LCD or a hand full of LEDs to indicate what I should wear. I would want to just use an ESP8266 to keep the cost down and so that I can put it to sleep most of the time to conserve batteries.

    I think this project would fit in nicely with your growing collection of weather related IoT projects, and could be a good candidate for a video or blog post ;) wink, wink.

    • Hahahaha, I like this plan. It's where I was trying to go with the "Smart Mirror" project, but I never got it to where I wanted. Having something that sits next to your coat closet would be good, though. Are you thinking of having something that just gives the day's forecast, or actually looks at all that data and makes a recommendation on what to wear?

      • floppystick6 / about 7 years ago / 1

        It would be something real simple like:

        if(high temp < 40°) then Coat;
        else if(chance of percip > 50%) then Rain Jacket;
        else if(high temp < 55°) then 
            if(wind speed > 20) then Coat;
            else Jacket;
        else T-Shirt;

        Depending on screen resolution/real-estate, it would be neat to also display the forecast's High temp, Chance of Precipitation, and wind speed.

        • That works--I like it. Next step: put BLE-connected LEDs on your coat hangers that light up to show you which coat to grab!

Related Posts

Recent Posts


All Tags