Including STAT Stories to Google Sheets Utilizing App Scripts

News Author

The creator’s views are totally his or her personal (excluding the unlikely occasion of hypnosis) and should not all the time mirror the views of Moz.

The group at MacMillan Search has generated a number of worth by combining automated STAT stories with Google Sheets. From including rating particulars to different software’s outputs, to giving the content material groups up-to-date “Folks Additionally Ask” stories, the top end result has confirmed to be an incredible time-saver in our week-to-week search engine optimisation workflows by lowering guide work and offering normal outputs that simply combine with any spreadsheet.

Why did we create this script?

STAT’s wealth of key phrase rankings particulars may be very helpful for enterprise SEOs to grasp each the macro and micro particulars of their rankings. Google Sheets is among the most typical cloud-based spreadsheets platforms, and is straightforward to share between groups and organizations. That’s why SEOs use each of those instruments commonly when analyzing key phrase knowledge.

Regardless of this, documentation on methods to combine STAT into Google Sheets is restricted. To handle this hole, we created our personal script!

It’s confirmed helpful for a number of causes:

  1. Not everybody likes CSVs: We leverage the STAT stories to supply shoppers with path. Having to obtain a CSV and open it each week isn’t for everybody. With this script, you’ll be able to set a weekly ticket with a hyperlink to the spreadsheet, and overview the output commonly.

  2. It saved us time: search engine optimisation is a marathon, not a dash. Once we determine a chance, there may be ongoing work that can have us reviewing stories commonly. The weekly ticket strategy to overview a spreadsheet shaves a while off of every process, and over the course of the engagement, this saved time provides up.

  3. Cleaner output: Utilizing Vlookups, Uniques, and so on., you’ll be able to create a abstract web page of this data, highlighting what shoppers and/or readers care about. It’s also possible to combine this data with different knowledge sources.

  4. Create automation with out utilizing an API: Automation, when executed accurately, saves time. Utilizing this script with triggers opens the door to automation.

How you can implement this script

1) Create a report in STAT

The STAT data base has a nice useful resource on stories. The one factor we’d get particular on is the naming of the report and the recipient e mail.


What you identify your report just isn’t as necessary as retaining it clear and concise. This makes scaling to different tasks with related stories cleaner and simpler. Additionally, you will use this report identify as one of many variables within the scripts.

We additionally counsel putting the corporate or challenge identify on the finish of the report identify in parentheses (e.g. “(MacMillan Search)”). This makes it simpler to search out the report in your e mail.

Recipient e mail

It’s necessary to make use of a Gmail-enabled e mail for the account the place you’ll be constructing the sheet. This fashion, Google has a neater time getting the app script to extract the CSV from the e-mail.


For our shoppers, weekly knowledge is essentially the most helpful — sufficient element to identify developments, however not a lot that it turns into simply noise to be ignored. For stories with restricted fluctuations (e.g. Folks Additionally Ask), month-to-month may be passable.


Choose “Run this report instantly” to substantiate that your report works, proper after creating the script. This fashion, you’re able to set your triggers and let the information stream.

The remainder of the settings are particular to what particulars you need out of your report.

2) Create a Google Sheet and add the script

Create a brand new sheet in Google Drive underneath the account related together with your report’s recipient e mail. Then you definitely’re prepared so as to add the script:

1. Beneath the menu “Instruments”, choose “<> Script editor”.

2. Paste the script under into the “Script editor”.

3. A couple of issues will must be edited to work together with your knowledge:

  • var COMPANY_NAME up to date to the corporate or challenge identify you used whereas creating the STAT Report

  • var REPORT_NAME up to date to the identify of your report minus the corporate identify and parentheses

  • var SHEET_NAME up to date to the identify of the sheet within the spreadsheet

4. Verify the Script works by saving it, refreshing the sheet, and when the menu “Handbook Replace” hundreds, choose “Import Key phrases”.

5. The primary time you run this you’re going to get an “Authorization Required” pop-up:

Choose “Proceed”, observe the steps, and choose “Import Key phrases” underneath the menu once more.

Your spreadsheet ought to now be populated with the entire particulars out of your CSV.

3) Automate the inhabitants with triggers

Setting this sheet as much as routinely replace because the report comes out may be very simple utilizing Apps Script “Triggers”. To arrange the triggers:

1. Return into the “Script Editor”

2. Choose the “alarm” icon “Triggers”

    3. Choose “Add Set off”.

    4. Choose the perform “importKws”.

    5. Choose occasion supply “Time-driven”.

    6. Choose kind of time-based set off “Week Timer” for weekly stories, “Month Timer” for month-to-month stories, and so on.

    7. In our time zone, our stories often come out late Sunday, so we decide early Monday morning:

    8. Click on “Save”

      The result’s a spreadsheet that commonly updates, populated by an emailed STAT report.

      We’ve discovered many makes use of for this script — anyplace we reference rank. And, since a challenge may take time to get carried out, we are able to present present rating data with out leveraging the API.

      We’re curious to learn the way you leverage it as properly. If you happen to discover the script helpful, attain out to us on LinkedIn and tell us what you’re utilizing it for.