Search API Connector Documentation


Import OpenWeatherMap Data to Google Sheets

In this guide, we’ll walk through how to pull data from the OpenWeatherMap API directly into Google Sheets, using the API Connector add-on for Sheets.

We’ll first get an API key from OpenWeatherMap, and then set up a request to pull in weather forecast details from OpenWeatherMap to your spreadsheet.


Before You Begin

Click here to install the API Connector add-on from the Google Marketplace.

Part 1: Get Your OpenWeatherMap API Key

  1. If you haven’t already, sign up for an account at
  2. Once you have an account, click your name to open the account menu and navigate to the API keys section.
  3. There should be a default API key already created for you (if not, you can click the ‘Generate’ button to make a new one). Keep it handy as we’ll need it shortly. That’s it! You now have access to OpenWeatherMap. Just note that OpenWeatherMap takes 15-20 minutes to recognize newly created API keys, so take a little break before moving to the next section.

Part 2: Create Your API Request URL

We’ll first access current weather data for a specific location.

  • API root:
  • Endpoint: /weather

Putting it all together, we get the full API Request URL:,uk&APPID=01...

Just substitute in your own API key and location of interest.

Part 3: Pull OpenWeatherMap API Data into Sheets

Now let’s copy that URL into API Connector.

  1. Open up Google Sheets and click Extensions > API Connector > Open.
  2. In the Create screen, enter the Request URL we just created
  3. Leave the headers section blank as we don’t need any headers for this request. We don’t need authentication either so just skip that section.
  4. Create a new tab and click Set current to use that tab as your data destination.
  5. Name your request and click Run. A moment later you’ll see weather data populate the OpenWeatherMap tab in your Google Sheet:openweathermap-api-img3

Part 4: Get More OpenWeatherMap Data

  1. When querying weather data from OpenWeatherMap, you can identify locations by either city name (q=London), city name + country code (q=London,uk), city ID (id=2172797), geographic coordinates (lat=35&lon=139), or zip code (zip=94040,us). If you’re interested in querying results for a specific city, use the city ID to avoid ambiguous results.
  2. Experiment with endpoints and query strings as described in the documentation to see other types of weather data. For example, you’d get a 5-day forecast for Moscow by entering the following:

    (Tip: When you run this query, note that the list.dt_txt field contains the date and time stamp for the forecast).

  3. You can query the following data collections for free: Current weather data, 5 day / 3 hour forecast, and Weather stations. There is also a One Call API that offers 1000 free API calls a day. Free accounts have limited service availability; if you query too rapidly you may receive the following error message: “Your account is temporary blocked due to exceeding of requests limitation of your subscription type.” In those cases, stop and wait for 10 minutes before repeating your request.

Part 5: API Documentation

Official API documentation:

Previous Import OpenSea Data to Google Sheets
Next Import PayPal Data to Google Sheets

19 thoughts on “Import OpenWeatherMap Data to Google Sheets”

  1. Hello, thanks for this useful article !
    How do you manage to only pull certain info like I would only want the weather >> main and main >> temp ?


  2. Cool, glad it was useful! The response will include all the data returned by OpenWeatherMap. If you’re only interested in certain fields, I suggest making another tab in Google Sheets that uses spreadsheet formulas to get what you’re looking for. For example, you could use this formula to pull in just columns C and N from a sheet named LondonWeather:

    =QUERY(LondonWeather!A:Z, “select C, N”)

    Let me know if that works for you!
    Update: You can now select specific fields using API Connector’s visual field editor.

  3. Is there a chance to pass a variable date to the API URL?
    e.g. I have a column of dates, and for each date I want the historical weather data.
    How can I pass the fields value (date as unix time) to the API URL?

    • Hi Peter, thanks for the message. To get historical weather data from OpenWeatherMap, you would send an API URL like this:{API key}

      In API Connector, you can reference a cell instead of hard coding a value, so the URL would actually look something like this:!A2+++&appid={API key}

      In cell A2, you’d enter the UNIX timestamp so that it would populate your URL. Note: in Sheets, you can convert a regular date to UNIX timestamp with the formula =(A1-DATE(1970,1,1))*86400, assuming A1 contains your date.

      Hope that helps point you in the right direction, let me know if I can clarify anything further.

      • Thanks Ana,

        works perfect for me!
        I just get weather data which don’t go along with the weather I see outside …but thats not the API connectors fault 😀

        For other who want to copy/paste Ana’s code:
        Be sure you choose a date within the last 5 days (free account) and use semicolons as separators in the date function.

      • Thank you for your followup, and for your extra tips, I’m glad that worked for you!

        Btw, the semi-colons vs. commas seems to be a setting in Sheets based on the Locale selected under File > Spreadsheet settings. If the locale is US (like mine), formulas require commas, while European locales seem to require semi-colons. Fun fun 🙂

  4. is it possible to query for data from a specific personal weather station? for example, my neighbor has a PWS and so do i; i want to compare the data i’m collecting specifically with the data he’s collecting … thx

  5. Hi Ana,

    Thanks for a great tool and documentation. I’m trying to create a “weather diary” for a trip I’m planning, and I want it to automatically fill in the weather-specific data from the Open Weather Map API. I already have the API working, I just don’t know how to organize my data.

    Let me try to explain: For every day in the future (limited to 7 by default), I want the sheet to populate weather data (e.g. max/min temp, description, rain, cloudiness etc.) for specific dates and places (lon/lat), which I have written in separate columns. I’m quite sure I can do this with some VLOOKUP.

    My problem comes with saving the weather data for the days which have passed, as the timemachine call only works for the previous 5 days. Do you have a good idea of how the sheet should only pull historic data once, and then not update the specific date again?

    I’ve created an example of what I’m trying to accomplish:

    Thanks in advance,

  6. My problem is I list several locations in my sheet, and I want the info to be pulled based on location and date, but the API show “just” one location. Would it be possible for the API to get data for the location per row?

      • Sorry, did not see that, and it would have worked perfectly if I was allowed to enter 2 ranges but only one is allowed:

        Request failed: multi-query requests may only include 1 range per line

        I think I’ll leave it for now, but thanks for very quick assistance!

      • You’re welcome! And for reference, to avoid that error you just need to first create your full list of URLs and then reference that, that way you’ll only be referencing one range per line.

Leave a Comment

Table of Contents