Google Weather API Feed Documentation

The base URL:

This is the base URL which can be extended with the following parameters:

The Weather parameter:

Where location can be either a zip code (weather=24060); city name, state (weather=woodland,PA); city name, country (weather=london,england); or possibly others. Try it out and see what response you get back to test your location.

The language parameter:
hl=ISO 639-1 Language Code

For example, to get the weather for Paris, France in French, one would use the following URL:,france&hl=fr

The Google Weather API is not an official public Google API so use it wisely. Also check out Yahoo’s Weather API for a more official, fully documented API.

27 Comments so far

  1. silviu on May 22nd, 2008

    what would be the ALL values for “condition data”?

  2. noyse on December 8th, 2008

    possible parameter: countrycode (ISO 3166-2:2007) and zipcode, separated by comma e.g. weather=DE,10115 :)

  3. Shu Jen Su on December 13th, 2008

    I would like to have a weather report on October16, 2008, February 23and 24, 2008.This report should include how many inch of rain on that day if any.Can I have this report as soon as possible.

    I am appreciate your response. Thank you and have a happy holidays.

  4. Mateusz Łapsa-Malawski on January 3rd, 2009

    It’s not an official api so it’s not an official bug report :)
    Do you mind adding “encoding=’UTF-8′”?

    PS: API is simple, quick – I like it.

  5. Jason on January 4th, 2009

    I don’t work for Google nor do I have any control over this API, I just documented it a bit to help out others…

    So I can’t add your encoding for you, sorry :(

  6. Arturro on January 8th, 2009

    In discussion people say it is unofficial.
    Do you know is it legible to use the API in a commercial project?
    Is there any terms or restrictions on the API and the data?

  7. Jason on January 8th, 2009


    Since the API is unofficial, there is no ToS or official restrictions. That being said, I would be very cautious to use this API in any project, let alone a commercial one.

  8. Mateusz Łapsa-Malawski on February 14th, 2009

    Starting from 12th api is disabled :(
    We can only hope for it to be temporary.

  9. Jason on February 14th, 2009

    The API appears to still be working for me. Were you getting an error or something?

  10. Rob on February 16th, 2009

    It’s not working for us either – I can request it manually and get data but I have it as a widget on my sites and it’s not able to display the data – it’s all blank.

  11. [...] the pieces together reading several blogs / forums etc. More unofficial documentation can be found here Also, I never found a proper actionscript library that enables us to retreive this data. [...]

  12. Jason on February 16th, 2009


    It is possible that Google has become wise about people using this API and is blocking automated requests. If you can manually request from the same IP address, maybe look into playing with the user-agent (they may only allow browser’s user-agents).

    Other than that, I would look into finding another data source such as Yahoo’s weather API.

  13. Roman on April 17th, 2009

    Google rules because it gives data for the upcoming days’ weather.
    And Yahoo just gives for the current day, and that’s it. If I’m mistaken, please let me know.

    Yahoo is more preferable to use because it’s well documented and all the weather condition codes are known.
    Google’s feed is a black box.

    Thanks for the post!

  14. Julien on April 29th, 2009

    Here a list of the Google Weather API condition,

    but i think some conditions are missing…

    I’m still looking for the complete conditions list,
    can you help me?

  15. Jason on April 29th, 2009

    Unfortunately, I do not have a list of all the conditions. Sorry.

  16. syed abdul baqi on June 15th, 2009


    can we fetch the forecast of multiple cities in single request?


  17. ninuhadida on June 19th, 2009

    running this api and requesting data on several cities, I got the following list of conditions.. there might be more though.

    | Clear
    | Cloudy
    | Fog
    | Haze
    | Light rain
    | Mostly Cloudy
    | Overcast
    | Partly Cloudy
    | Rain
    | Rain Showers
    | Showers
    | Thunderstorm
    | Chance of Showers
    | Chance of Snow
    | Chance of Storm
    | Mostly Sunny
    | Partly Sunny
    | Scattered Showers
    | Sunny

  18. Dimitar Shterionov on June 28th, 2009

    Hi to all, I am interested in google weather api , because unlikely other weather services it provides the data in a well-ordered xml. Unfortunately I couldn’t get the api to return me the data for all of the region my site is about. Well basically, I created a loop for every city in Greece (this is the region I am working on) and sending a request a gather the info, or at least this is the idea. But google sent me an error massage that my program is acting as a virus or a spyware. Something that it is not. But… that’s google’s decision. So if someone has some idea how to fix this problem, I would appreciate if share it. Thank you in advance, have a nice day.

  19. Jason on June 28th, 2009


    It sounds like you have been requesting data from the weather API at a rate that makes you look like you are doing something evil. I would recommend adding rate limiting to your code which makes the requests. I would start with something like 1 request per minute and then cache those results so that every page view on your website is not hitting Google 100 times or whatever (if that is how it works).

    As far as fixing the problem, when you view the weather API URL in your browser, do you have the option to enter a captcha? This is what Google does for search requests that look like spam? My only other suggestion would be to not access the weather API for a couple days and see if you ban has been lifted. Otherwise, I would recommend looking into another weather source such as Yahoo. Their format is standard as well so you should not have an issue parsing it.

  20. Dimitar Shterionov on June 28th, 2009

    Ok, Thank you once again.
    1. Because of the (supposed) rate the website should be used and the times a user would refresh it it is not possible to use some time-restriction based algorithm.
    2. So the solution is trying yahoo weather api. Or some other similar program.
    3. But i hope that google would make some program solving my problem.
    Have a nice day.

  21. Dimitar Shterionov on June 28th, 2009

    Hi, and really thank you… what you are suggesting, about the local storing of the data, I think could do. I would create such a script and calling the google api (I prefer the google api for the structure of the xml which reterns) would store a local file.
    About what I am trying to do actually it should look like:

    and then if you choose extra -> weather you will get the weather – this is my goal.

    Thank you once again.
    Have nice evening.

  22. Nathan on July 9th, 2009 also has an API. You have to sign up for a license but it’s free. I used it to build the weather widget on It comes with a pack of translucent .png images to represent all of the conditions.
    That being said, it’s kind of slow, and I had to create a php script that cURLed the data to a local source to quickly access it as a local javascript source for parsing. I’d prefer to use Google’s method, as it’s fast and simple, but as it’s undocumented, I’m worried about building too much on it.

  23. MartinaGilbert on July 23rd, 2009

    I cannot believe this will work!

  24. Matt on July 27th, 2009

    Do you have a working version written in ColdFusion?

  25. Stephen Collins on July 30th, 2009

    I actually got this to work in .asp.

    Took forever to figure out, but returned everything i needed in just 8 lines of code.

  26. antony on August 12th, 2009

    Anyone knows the update time that Google refreshes their weather information? If they change it once in one hour, doesn’t make any sense to call this service several times in one hour.

  27. [...] weather information is fetched from google weather api. The location and the unit are configurable. The api provides forecast only for the next 3 days, so [...]