rankings

Top search results captured for a keyword

Answers up to 50 entries of the day asked for, or of the newest captured day. Each entry carries its iconUrl, titleMatch and titleSegments, and previous, delta and movement against comparedTo, the newest captured day before date. Movement is none when there is no earlier capture or the earlier capture did not reach that position. exits lists the apps of that earlier capture no longer listed, and dates lists up to 365 captured days, newest first.

GET

keywords

{keywordId}

serp

Top search results captured for a keyword

curl --request GET \
  --url http://localhost:3000/api/backend/keywords/{keywordId}/serp \
  --header 'Authorization: Bearer <token>'

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

fetch('http://localhost:3000/api/backend/keywords/{keywordId}/serp', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "http://localhost:3000/api/backend/keywords/{keywordId}/serp"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

keywordId

string

required

Query Parameters

date

string

Pattern: ^\d{4}-\d{2}-\d{2}$

Example:

"2026-08-21"

Response

200 - application/json

The response is of type object.

Top search results captured for a keyword

curl --request GET \
  --url http://localhost:3000/api/backend/keywords/{keywordId}/serp \
  --header 'Authorization: Bearer <token>'

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

fetch('http://localhost:3000/api/backend/keywords/{keywordId}/serp', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "http://localhost:3000/api/backend/keywords/{keywordId}/serp"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{}

Overview

Endpoints

Top search results captured for a keyword

Authorizations

Path Parameters

Query Parameters

Response