Amazon Rank Tracking API

Positions by day

One row per keyword and UTC day: the median, best and worst position.

POST

https://api.screamingdata.dev/v1/amazon/rank_tracking/daily

Authentication: API key (HTTP Basic)
Cost: Free
Body: Array of up to 100 tasks

Overview

Returns the keywords you track (or tracked) for an ASIN as one row per keyword and UTC day, newest first: the median position of the day's checks that found the product (organic_rank), the best and the worst, how many checks there were and in how many the product was found. Days without a check are left out.

Search results vary between visits, especially below the first few positions, so a day's median is a steadier figure than any single check.

Cost

Free.

Request

POST /v1/amazon/rank_tracking/daily with Content-Type: application/json.

Body fields

The request body is a JSON array of 1–100 task objects. Each object has these fields:

asin

stringrequired

ASIN you track or tracked.

Pattern^[A-Z0-9]{10}$
ExampleB0EXAMPLE1

marketplace

stringrequired

Marketplace code. The aliases us and usa (for com) and gb (for uk) are also accepted. See Marketplaces.

Allowedcomukdefresitnlcaaujpmxin
Examplecom

keyword

stringoptional

Only this keyword; every keyword you track or tracked for the ASIN when absent.

Max length200 characters
Examplewireless earbuds

days

integeroptional

UTC days to return, today included.

Default30
Range1 – 400
Example7

Request example

The examples read your credentials from the API_LOGIN and API_KEY environment variables.

curl --request POST \
  --url "https://api.screamingdata.dev/v1/amazon/rank_tracking/daily" \
  --user "$API_LOGIN:$API_KEY" \
  --header "Content-Type: application/json" \
  --data '[
  {
    "asin": "B0EXAMPLE1",
    "marketplace": "com",
    "keyword": "wireless earbuds",
    "days": 7
  }
]'

import os

import requests

response = requests.post(
    "https://api.screamingdata.dev/v1/amazon/rank_tracking/daily",
    auth=(os.environ["API_LOGIN"], os.environ["API_KEY"]),
    json=[
        {
            "asin": "B0EXAMPLE1",
            "marketplace": "com",
            "keyword": "wireless earbuds",
            "days": 7,
        },
    ],
    timeout=30,
)
data = response.json()
print(data["status_code"], data["status_message"], "cost:", data["cost"])
for task in data["tasks"]:
    print(task["id"], task["status_code"], task["status_message"])

const auth = Buffer.from(`${process.env.API_LOGIN}:${process.env.API_KEY}`).toString("base64");

const response = await fetch("https://api.screamingdata.dev/v1/amazon/rank_tracking/daily", {
  method: "POST",
  headers: {
    Authorization: `Basic ${auth}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify([
    {
      asin: "B0EXAMPLE1",
      marketplace: "com",
      keyword: "wireless earbuds",
      days: 7,
    },
  ]),
});
const data = await response.json();
console.log(data.status_code, data.status_message, "cost:", data.cost);
for (const task of data.tasks) {
  console.log(task.id, task.status_code, task.status_message);
}

Response

HTTP 200. The body is the standard response envelope; check status_code at the top level and in every task.

Response example

{
  "version": "1.0.0",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0023 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "10031504-1c7d-4b9e-a5f3-8e2d6a0c4b17",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0023 sec.",
      "cost": 0,
      "result_count": 3,
      "path": [
        "v1",
        "amazon",
        "rank_tracking",
        "daily"
      ],
      "data": {
        "api": "amazon",
        "function": "rank_tracking",
        "asin": "B0EXAMPLE1",
        "marketplace": "com",
        "keyword": "wireless earbuds",
        "days": 7
      },
      "result": [
        {
          "keyword": "wireless earbuds",
          "date": "2026-10-03",
          "organic_rank": 7,
          "organic_rank_min": 7,
          "organic_rank_max": 7,
          "checks": 1,
          "found_checks": 1,
          "checked_depth": 100,
          "matched_asin": "B0EXAMPLE1",
          "matched_format": null
        },
        {
          "keyword": "wireless earbuds",
          "date": "2026-10-02",
          "organic_rank": 9,
          "organic_rank_min": 9,
          "organic_rank_max": 9,
          "checks": 1,
          "found_checks": 1,
          "checked_depth": 100,
          "matched_asin": "B0EXAMPLE1",
          "matched_format": null
        },
        {
          "keyword": "wireless earbuds",
          "date": "2026-10-01",
          "organic_rank": 12,
          "organic_rank_min": 12,
          "organic_rank_max": 12,
          "checks": 1,
          "found_checks": 1,
          "checked_depth": 100,
          "matched_asin": "B0EXAMPLE2",
          "matched_format": null
        }
      ]
    }
  ]
}

Result fields

Each element of tasks[].result is a positions of one day. One keyword on one UTC day, from every check of that day.

keyword

string

The keyword.

date

string (date)

The UTC day, YYYY-MM-DD.

organic_rank

integer· nullable

Median position of the day's checks that found the product (the lower middle value for an even number); null when no check found it.

organic_rank_min

integer· nullable

Best position of the day.

organic_rank_max

integer· nullable

Worst position of the day.

checks

integer

Checks made that day.

found_checks

integer

Checks that found the product.

checked_depth

integer· nullable

The deepest check of the day, in organic positions.

matched_asin

string· nullable

The listing found at the best position.

matched_format

string· nullable

Its label in search, when it had one.

Status codes

Codes this endpoint can return, at the request or task level. See Status codes for handling advice.

Code	Message	HTTP	Level	When
20000	Ok.	200	Request / task	The request, or the individual task, was processed successfully.
40000	Bad Request.	400 / 200	Request / task	The body is not valid JSON or does not have the expected shape (for example, not an array of task objects, or more than one task for live). Also returned with HTTP 413 for bodies larger than 1 MiB and with HTTP 405 for a wrong HTTP method. As a task-level code (HTTP 200) it means the task cannot be carried out as asked, for example because the account already has the maximum number of API keys or monitored products.
40001	Too many tasks in one request (max 100).	400	Request	A POST body contains more task objects than allowed.
40100	Authentication failed.	401	Request	The Authorization header is missing or malformed, or the login and API key do not match.
40101	API key revoked.	401	Request	The API key was revoked. Use another active key or create a new one.
40102	Account disabled.	401	Request	The account is disabled. Contact support.
40202	Rate limit exceeded.	429	Request	Too many requests or tasks per minute for this account, or too many access requests from one IP address. The Retry-After header says how many seconds to wait.
40501	Invalid field: `<name>`.	400 / 200	Request / task	A field has a wrong type, format or value; the message names the field, for example "Invalid field: `priority`."
40502	Unknown marketplace.	200	Task	The marketplace is not one of the 12 supported codes or their aliases.
40503	Invalid ASIN.	200	Task	The ASIN does not match ^[A-Z0-9]{10}$ after uppercasing.
40600	Feature not available on your plan.	403	Request	The requested feature is not enabled for this account.
50000	Internal error.	500	Request	Unexpected server error. The request can be retried; contact support if it persists.

Overview#

Request#

Body fields

Request example#

Response#

Result fields#

Status codes#

Related endpoints#

Overview

Request

Request example

Response

Result fields

Status codes

Related endpoints