Skip to content
Screaming Data
Documentation menu

Amazon Rank Tracking API

Stop tracking keyword positions

Stop tracking keywords by id, or every keyword (or one) of an ASIN.

POST
https://api.screamingdata.dev/v1/amazon/rank_tracking/delete
Authentication
API key (HTTP Basic)
Cost
Free
Body
Array of up to 100 tasks

Overview

Stops tracking, each element identified by id, or by asin and marketplace — every keyword of that ASIN, or only keyword when it is given. Positions already recorded stay readable with rank_tracking/history and rank_tracking/daily.

When nothing matches, the task fails with 40400.

Cost

Free.

Request

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

Body fields

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

id
integeroptional

Tracking id. Required unless asin and marketplace are given.

  • Range≥ 1
  • Example5120
asin
stringoptional

ASIN. Required together with marketplace when id is not given.

  • Pattern^[A-Z0-9]{10}$
  • ExampleB0EXAMPLE2
marketplace
stringoptional

Marketplace. Required together with asin when id is not given.

  • Allowedcomukdefresitnlcaaujpmxin
  • Exampleuk
keyword
stringoptional

Only this keyword of the ASIN; every keyword of it when absent.

  • Max length200 characters
  • Examplebluetooth speaker

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/delete" \
  --user "$API_LOGIN:$API_KEY" \
  --header "Content-Type: application/json" \
  --data '[
  {
    "id": 5120
  },
  {
    "asin": "B0EXAMPLE2",
    "marketplace": "uk",
    "keyword": "bluetooth speaker"
  }
]'

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.0191 sec.",
  "cost": 0,
  "tasks_count": 2,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "10030915-2a7c-4f0e-b3d1-9c6e8a4f2d57",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0049 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v1",
        "amazon",
        "rank_tracking",
        "delete"
      ],
      "data": {
        "api": "amazon",
        "function": "rank_tracking",
        "id": 5120
      },
      "result": [
        {
          "id": 5120,
          "asin": "B0EXAMPLE1",
          "marketplace": "com",
          "keyword": "wireless earbuds",
          "status": "deleted",
          "deleted_at": "2026-10-03T09:15:02Z"
        }
      ]
    },
    {
      "id": "10030915-6d3b-4a8c-91e2-5f7b0c3e1a46",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0049 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v1",
        "amazon",
        "rank_tracking",
        "delete"
      ],
      "data": {
        "api": "amazon",
        "function": "rank_tracking",
        "asin": "B0EXAMPLE2",
        "marketplace": "uk",
        "keyword": "bluetooth speaker"
      },
      "result": [
        {
          "id": 5122,
          "asin": "B0EXAMPLE2",
          "marketplace": "uk",
          "keyword": "bluetooth speaker",
          "status": "deleted",
          "deleted_at": "2026-10-03T09:15:02Z"
        }
      ]
    }
  ]
}

Result fields

Each element of tasks[].result is a keyword no longer tracked. Confirmation for one keyword that is no longer tracked.

id
integer

Tracking id.

asin
string

ASIN.

marketplace
string

Marketplace code.

keyword
string

Keyword.

status
string

Always deleted.

deleted_at
string (date-time)

When tracking stopped, ISO 8601 in UTC.

Status codes

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

CodeMessageHTTPLevelWhen
20000Ok.200Request / taskThe request, or the individual task, was processed successfully.
40000Bad Request.400 / 200Request / taskThe 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.
40001Too many tasks in one request (max 100).400RequestA POST body contains more task objects than allowed.
40100Authentication failed.401RequestThe Authorization header is missing or malformed, or the login and API key do not match.
40101API key revoked.401RequestThe API key was revoked. Use another active key or create a new one.
40102Account disabled.401RequestThe account is disabled. Contact support.
40202Rate limit exceeded.429RequestToo 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.
40400Not Found.404 / 200Request / taskUnknown endpoint, or an unknown task, key or subscription id.
40501Invalid field: `<name>`.400 / 200Request / taskA field has a wrong type, format or value; the message names the field, for example "Invalid field: `priority`."
40502Unknown marketplace.200TaskThe marketplace is not one of the 12 supported codes or their aliases.
40503Invalid ASIN.200TaskThe ASIN does not match ^[A-Z0-9]{10}$ after uppercasing.
40600Feature not available on your plan.403RequestThe requested feature is not enabled for this account.
50000Internal error.500RequestUnexpected server error. The request can be retried; contact support if it persists.

Related endpoints