SERP rank tracking

GET

serp

SERP rank tracking

curl --request GET \
  --url https://api.scrapeswitch.com/serp \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.scrapeswitch.com/serp', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.scrapeswitch.com/serp"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Get ranked, structured search results for a keyword — no HTML to scrape or parse — for rank tracking, SERP feature monitoring, or competitive research.

Use case

Track where a domain ranks for a set of target keywords over time
Monitor SERP features (knowledge graph, People Also Ask, sitelinks) appearing for a query
Pull competitor pages ranking for a keyword, then fetch their content in the same request

Sample request

curl -G "https://api.scrapeswitch.com/serp" \
  -H "Authorization: Bearer $API_KEY" \
  --data-urlencode "query=wireless headphones" \
  --data-urlencode "country=US" \
  --data-urlencode "language=en" \
  --data-urlencode "mode=full"

import os
import httpx

response = httpx.get(
    "https://api.scrapeswitch.com/serp",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    params={"query": "wireless headphones", "country": "US", "language": "en", "mode": "full"},
    timeout=60.0,
)
response.raise_for_status()
data = response.json()
for result in data["organic"]:
    print(result["position"], result["title"], result["link"])

const params = new URLSearchParams({
  query: "wireless headphones",
  country: "US",
  language: "en",
  mode: "full",
});

const response = await fetch(`https://api.scrapeswitch.com/serp?${params}`, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});

const data = await response.json();
data.organic.forEach((r) => console.log(r.position, r.title, r.link));

Tracking rank over time

Run the same query on a schedule (daily is typical for rank tracking) and log each result’s position for the domains you care about:

Python

TRACKED_DOMAINS = ["example.com"]

for result in data["organic"]:
    if result["domain"] in TRACKED_DOMAINS:
        store_rank(query="wireless headphones", domain=result["domain"], position=result["position"])

Pulling page content for top results

Add output to enrich each organic result with the result page’s own content in the same request — useful for content-gap analysis against top-ranking pages:

GET /serp?query=wireless+headphones&mode=fast&output=clean_html,links

Each result then includes cleanHtml/links alongside its normal fields. This is billed as one ordinary scrape per result attempted — see Output.

Request highlights

Setting	Value	Why
`mode`	`full` (default)	Adds knowledge graph, People Also Ask, and sitelinks when available
`country` / `language`	`US` / `en`	Localizes results — vary these to compare rankings by region
`tbs`	`qdr:d` / `qdr:w` / `qdr:m`	Filters to recent results for freshness-sensitive queries

Tips

Use mode=fast when you only need ranked links — it’s cheaper and faster than full.
Not every engine surfaces every SERP feature or an estimated result total — treat their absence as normal, not an error.
Vary country to compare regional rankings (US, GB, DE) for the same keyword.

SERP rank tracking

curl --request GET \
  --url https://api.scrapeswitch.com/serp \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.scrapeswitch.com/serp', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.scrapeswitch.com/serp"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Get started

Endpoints

Teams

Billing

Recipes

Monitoring

SERP rank tracking

Use case

Sample request

Tracking rank over time

Pulling page content for top results

Request highlights

Tips

​Use case

​Sample request

​Tracking rank over time

​Pulling page content for top results

​Request highlights

​Tips

​Related

Use case

Sample request

Tracking rank over time

Pulling page content for top results

Request highlights

Tips

Related