Track keyword rankings, news and SERP features on Google

import csv
import datetime
import requests

API_URL = "https://api.dataguru.cc/api/v1/google/search"
HEADERS = {"Authorization": "Api-Key YOUR_API_KEY"}

MY_DOMAIN = "example.com"
KEYWORDS = ["trail running shoes", "waterproof hiking boots"]
COUNTRY = "us"


def position(keyword):
    res = requests.post(
        API_URL,
        headers=HEADERS,
        json={"query": keyword, "country": COUNTRY, "num_results": "50"},
        timeout=60,
    )
    res.raise_for_status()
    for result in res.json().get("organic_results", []):
        if MY_DOMAIN in result.get("link", ""):
            return result["rank"], result["link"]
    return None, None


with open("rankings.csv", "a", newline="") as f:
    writer = csv.writer(f)
    today = datetime.date.today().isoformat()
    for keyword in KEYWORDS:
        rank, url = position(keyword)
        writer.writerow([today, COUNTRY, keyword, rank, url])

{
  "search_information": {
    "total_results": 48200000,
    "query_displayed": "trail running shoes"
  },
  "organic_results": [
    {
      "rank": 1,
      "title": "The Best Trail Running Shoes, Tested",
      "link": "https://www.example-reviews.com/trail-running-shoes",
      "displayed_link": "example-reviews.com › gear",
      "snippet": "We ran hundreds of miles to find the best shoes for grip and comfort."
    },
    {
      "rank": 2,
      "title": "Trail Running Shoes for Men & Women",
      "link": "https://www.example.com/trail-running-shoes",
      "displayed_link": "example.com › shoes › trail",
      "snippet": "Shop lightweight trail runners with free returns."
    }
  ],
  "related_searches": [
    {
      "query": "best trail running shoes for beginners"
    }
  ]
}