SERP rank tracking

GET

serp

SERP rank tracking

curl --request GET \
  --url https://apix.pline.ai/v1/serp \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://apix.pline.ai/v1/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://apix.pline.ai/v1/serp"

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

	req.Header.Add("X-API-Key", "<api-key>")

	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
Find the pages ranking for a keyword, then scrape their content with Batch scrape

Sample request

curl -G "https://apix.pline.ai/v1/serp" \
  -H "X-API-Key: $API_KEY" \
  --data-urlencode "query=wireless headphones" \
  --data-urlencode "country=US" \
  --data-urlencode "language=en" \
  --data-urlencode "tag=rank.wireless-headphones"

import os
import httpx

response = httpx.get(
    "https://apix.pline.ai/v1/serp",
    headers={"X-API-Key": os.environ["API_KEY"]},
    params={"query": "wireless headphones", "country": "US", "language": "en", "tag": ["rank.wireless-headphones"]},
    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",
  tag: "rank.wireless-headphones",
});

const response = await fetch(`https://apix.pline.ai/v1/serp?${params}`, {
  headers: { "X-API-Key": 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 the position of the domains you care about. This script is complete: it appends one row per tracked result to ranks.csv. A domain that doesn’t appear in the results gets no row for that day.

Python

import csv
import os
from datetime import date
from pathlib import Path

import httpx

QUERY = "wireless headphones"
TRACKED_DOMAINS = {"example.com"}
RANKS_FILE = Path("ranks.csv")

response = httpx.get(
    "https://apix.pline.ai/v1/serp",
    headers={"X-API-Key": os.environ["API_KEY"]},
    params={"query": QUERY, "country": "US", "language": "en", "tag": ["rank.wireless-headphones"]},
    timeout=60.0,
)
response.raise_for_status()
organic = response.json()["organic"]

new_file = not RANKS_FILE.exists()
with RANKS_FILE.open("a", newline="") as f:
    writer = csv.writer(f)
    if new_file:
        writer.writerow(["date", "query", "domain", "position", "url"])
    for result in organic:
        if result["domain"] in TRACKED_DOMAINS:
            writer.writerow([date.today().isoformat(), QUERY, result["domain"], result["position"], result["link"]])

Reading the pages that rank

To analyze the pages ranking for a keyword, pass their link values to Batch scrape and request the output you need, such as markdown.

Request highlights

Setting	Value	Why
`country` / `language`	`US` / `en`	Localizes results — vary these to compare rankings by region
`tag`	per keyword or campaign	Lets you filter and trace each tracked search in Request history

Tips

Not every SERP feature, or the estimated result total, is always available — 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://apix.pline.ai/v1/serp \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://apix.pline.ai/v1/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://apix.pline.ai/v1/serp"

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

	req.Header.Add("X-API-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

​Use case

​Sample request

​Tracking rank over time

​Reading the pages that rank

​Request highlights

​Tips

​Related

Use case

Sample request

Tracking rank over time

Reading the pages that rank

Request highlights

Tips

Related