Build Keyword Rank Tracker with Python

Why build keyword rank tracker python matters for developers

Start with a direct request and parser. This baseline matters because it shows why initial success can be misleading. You might get parseable HTML for a few requests and assume the job is done, but production scraping quality is measured over time and volume, not by one isolated response.

Search-result collection usually feeds rank tracking, competitor monitoring, AI dataset collection, or lead generation workflows. Those use cases need clean schemas, reliable retries, and blocked-response detection instead of one lucky HTML response.

Step 1 - simple Python scraper

# naive rank tracker sketch (fragile)
import requests
from bs4 import BeautifulSoup

keywords = ["best ai tools", "best seo tools"]
domain = "example.com"

for kw in keywords:
    url = "https://www.google.com/search?q=" + kw.replace(" ", "+")
    html = requests.get(url, headers={"User-Agent": "Mozilla/5.0"}, timeout=30).text
    soup = BeautifulSoup(html, "html.parser")
    links = [a.get("href", "") for a in soup.select("a")]
    rank = next((i + 1 for i, href in enumerate(links) if domain in href), None)
    print(kw, rank)

This script intentionally has no queueing, no anti-block strategy, no retry policy, and no schema guardrails. It is useful for a proof of concept, but it is not a reliable extraction system yet.

Common problems and how to fix them

The next stage is predictable. After repeated requests, Google starts returning challenge pages, partial responses, or rate-limit status codes. Your parser still runs, but the input is no longer a valid SERP document. This is where most prototypes become unstable.

• CAPTCHA challenge HTML replaces normal result markup.
• HTTP `429` appears during burst traffic or tight retry loops.
• HTTP `503` appears when suspicious traffic is throttled.
• Unusual traffic detection text appears in page titles and body content.

HTTP/1.1 429 Too Many Requests

or

HTTP/1.1 503 Service Unavailable

<title>Sorry...</title>
Our systems have detected unusual traffic from your computer network.
To continue, please complete the CAPTCHA.

At this point the bottleneck is no longer selector parsing. The bottleneck is trust, behavior, and delivery infrastructure.

Why Google blocks web scrapers in production environments

Datacenter IP detection and reputation scoring

Google evaluates request source quality, ASN reputation, and prior abuse history. Traffic from cloud and VPS ranges is often scored as high-risk for automation, especially when query patterns are repetitive.

TLS and transport fingerprinting

Modern detection does not stop at headers. Handshake patterns, protocol behavior, and client implementation details can expose automation signatures.

Browser entropy, cookie challenges, and behavior scoring

Headless clients leak automation patterns through JavaScript APIs, navigator state, and timing behavior. Once trust drops, cookie-bound challenge flows and CAPTCHA checks are served instead of normal SERP payloads.

Dynamic SERP rendering and module completeness

Even before hard blocking, many SERP modules are rendered dynamically. Without browser-grade execution, People Also Ask, local packs, and shopping blocks can be incomplete or missing.

Attempted fixes and why they still fail

Most teams cycle through the same temporary mitigations. Each tactic helps a little, but none removes the operational burden of keeping extraction stable every day.

The real problem: this is infrastructure, not parsing

Teams often think build keyword rank tracker python is a selector problem. In practice, the expensive part is operating a reliable anti-bot delivery system with predictable latency and failure handling.

• Distributed request queues with backpressure and retry control
• IP pool quality management and geolocation-aware routing
• Block detection, challenge classification, and failover logic
• Browser/runtime fingerprint management across worker fleets
• Cost controls for retries, pagination depth, and concurrency

Python vs OrbitScraper API approach

A SERP API abstracts retrieval, anti-block handling, and normalization into a stable contract so application code can consume structured results rather than brittle HTML.

• Queued request admission with predictable polling states.
• Execution workers that apply retries and backoff centrally.
• Normalized JSON fields for downstream analytics and product logic.
• Fewer moving parts in your codebase and smaller on-call surface area.

OrbitScraper is one example of this approach; your team can then focus on product logic instead of maintaining anti-bot infrastructure. For a broader build-versus-buy view, read Python BeautifulSoup scraper: why it breaks, read the API documentation, view OrbitScraper pricing, and see all use cases.

Build a Python keyword rank tracker step by step

The following code is designed for production workflow shape, not just demo output. It includes enqueue, poll loop, terminal error checks, and multi-page pagination handling.

import sqlite3

conn = sqlite3.connect("rank_history.db")
conn.execute(
    """
    create table if not exists keyword_rank_snapshots (
      query text,
      location text,
      tracked_domain text,
      rank integer,
      checked_at text
    )
    """
)
conn.execute(
    "insert into keyword_rank_snapshots values (?, ?, ?, ?, datetime('now'))",
    ("best ai tools", "new york,ny", "example.com", 4),
)
conn.commit()

from apscheduler.schedulers.blocking import BlockingScheduler

scheduler = BlockingScheduler(timezone="UTC")

@scheduler.scheduled_job("cron", hour="*/6")
def collect_rank_snapshots():
    run_rank_collection()

scheduler.start()

Step 4 - OrbitScraper API implementation

# production-friendly rank tracker using OrbitScraper
import time
import requests

BASE_URL = "https://api.orbitscraper.com"
API_KEY = "ORS_xxx"
KEYWORDS = ["best ai tools", "best seo tools"]
DOMAIN = "example.com"

def enqueue(kw):
    res = requests.post(
        f"{BASE_URL}/v1/search",
        headers={"x-api-key": API_KEY, "Content-Type": "application/json"},
        json={"q": kw, "location": "United States", "gl": "us", "hl": "en", "num": 10, "page": 1},
        timeout=30,
    )
    res.raise_for_status()
    return res.json()["jobId"]

def poll(job_id):
    for _ in range(90):
        r = requests.get(f"{BASE_URL}/v1/search/{job_id}", headers={"x-api-key": API_KEY}, timeout=30)
        r.raise_for_status()
        payload = r.json()
        if payload["status"] == "completed":
            return payload["result"]
        if payload["status"] in ("failed", "expired"):
            raise RuntimeError(payload.get("code"))
        time.sleep(1)
    raise TimeoutError("timeout")

for kw in KEYWORDS:
    job_id = enqueue(kw)
    result = poll(job_id)
    organic = result.get("organic_results", [])
    rank = next((row.get("position") for row in organic if DOMAIN in row.get("link", "")), None)
    print({"keyword": kw, "rank": rank})

Step 5 - Pagination and retry wrapper

def fetch_paginated_results(query, pages=3):
    all_pages = []
    for page in range(1, pages + 1):
        for attempt in range(1, 4):
            try:
                job_id = enqueue(query, page=page)
                result = poll(job_id)
                all_pages.append({"page": page, "result": result})
                break
            except Exception as exc:
                if attempt == 3:
                    raise RuntimeError(f"page_{page}_failed: {exc}")
                time.sleep(0.5 * (2 ** attempt))
    return all_pages

Request creation

`POST /v1/search` creates a job and returns a `jobId`. This decouples client latency from upstream fetch time and keeps workers predictable under load.

Polling

Poll GET /v1/search/{jobId} until status becomes completed. Handle failed and expired as terminal outcomes, and retry only transient failures with backoff.

Pagination

Each page is an independent API call. Limit maximum page depth by use case to control cost. Store per-page metadata so troubleshooting is faster when partial batches fail.

Example JSON response

{
  "jobId": "job_32ee98db-3378-4d25-a177-1f7f2b8a63fd",
  "status": "completed",
  "result": {
    "search_metadata": {
      "id": "job_32ee98db-3378-4d25-a177-1f7f2b8a63fd",
      "status": "Success",
      "created_at": "2026-02-24T10:21:00.000Z",
      "processing_time_ms": 488,
      "credits_used": 1,
      "source": "live"
    },
    "search_parameters": {
      "q": "best ai tools",
      "location": "United States",
      "gl": "us",
      "hl": "en",
      "device": "desktop",
      "num": 10,
      "page": 1
    },
    "organic_results": [
      {
        "position": 1,
        "title": "Top AI Tools in 2026",
        "link": "https://example.com/top-ai-tools",
        "snippet": "A practical list of tools for coding, research, and automation."
      }
    ],
    "people_also_ask": [
      { "question": "What is the best AI tool?" }
    ],
    "related_searches": [
      "best ai coding tools",
      "ai productivity tools"
    ]
  }
}

Real-world use cases

• Daily keyword rank monitors
• Client SEO reporting
• Competitor rank alerts
• Portfolio keyword trend dashboards
• Competitor monitoring by query cluster and domain visibility share.
• Lead generation pipelines that identify ranking pages in niche verticals.
• AI dataset collection for retrieval, evaluation, and prompt-grounded workflows.

Best practices: reliability, cost, and throughput

• Cache repeated queries and low-volatility terms to avoid paying twice for unchanged data.
• Use bounded retries with exponential backoff for transient network and upstream status errors.
• Treat each page of pagination as an independent unit of work with its own timeout and retry budget.
• Store raw response payloads and normalized tables separately so parser changes do not break historical analytics.
• Set concurrency caps per project to prevent retry storms during temporary rate-limit pressure.
• Log request IDs, queue latency, success rate, and error codes as first-class production metrics.
• Run scheduled freshness checks on tracked keywords so dashboards stay current and trustworthy.
• Alert on abnormal credit usage and failure spikes before they become customer-visible incidents.

Related Google scraping queries

These are long-tail questions developers search while debugging scraping workflows. Answering them directly improves implementation quality and helps expand keyword coverage naturally.

• Can Google detect web scraping?
• Is Selenium blocked by Google?
• How many requests before Google blocks an IP?
• Does rotating proxies help for Google scraping?
• How to avoid CAPTCHA when scraping search results?

When DIY scraping still makes sense

Libraries like BeautifulSoup, cheerio, Jsoup, and goquery are still excellent for static sources where anti-bot pressure is low.

• Blog archives and static content hubs.
• Documentation sites with stable HTML structure.
• Public pages without aggressive anti-automation controls.

For Google-like surfaces, reliability usually depends more on delivery infrastructure than parser quality.

Frequently Asked Questions

Related Blogs