Watchlists

POST

/v1/watchlists

Create a watchlist

GET

/v1/watchlists

List watchlists

GET

/v1/watchlists/{id}

Get a watchlist

PATCH

/v1/watchlists/{id}

Update a watchlist

DELETE

/v1/watchlists/{id}

Delete a watchlist

POST

/v1/watchlists/{id}/run

Run a watchlist now

GET

/v1/watchlists/scrapers

List pipeline scrapers

GET

/v1/watchlists/{id}/runs

List runs

GET

/v1/watchlists/{id}/items

List items

POST

/v1/watchlists/{id}/items

Add or remove items

POST

/v1/watchlists/{id}/asins

Add or remove items (legacy path) (deprecated)

Idempotency-Key

string

—

Retrying with the same key returns the original response (Idempotent-Replayed: true) instead of creating a second list. Remembered 24 hours. Up to 255 characters.

name

string

yes

Up to 100 characters.

ids

string[]

yes

1 to 50,000 item ids of platform (ASINs, item ids, TCINs, SKUs…; de-duplicated). A newline- or comma-separated string is also accepted.

asins

string[]

—

Deprecated. Amazon only, legacy: the same as ids (ASINs are case-insensitive). Send ids or asins, not both. At most 50,000 items.

every

string

—

Cadence, start to start: whole minutes, hours or days, at least 5 minutes, at most 7 days. E.g. 5m, 15m, 1h, 6h, 24h. Send this or cron.

cron

string

—

Standard 5-field cron (minute hour day-of-month month day-of-week) read in timezone: *, lists (1,15), ranges (9-17), steps (*/15, 0-30/10), names (JAN-DEC, SUN-SAT; 0 and 7 are Sunday), and @hourly, @daily, @weekly, @monthly, @yearly. No seconds. When both day fields are restricted a day matches either (Vixie cron). Must not fire more often than every 5 minutes. Across DST a skipped local time runs once, shifted forward by the gap, and a repeated one runs once, at its first occurrence. Send this or every.

timezone

string

—

IANA time zone the cron is read in, e.g. America/New_York, Europe/London. Default UTC. Only with cron.

webhook_url

string

—

One of your registered webhook endpoints (/v1/webhook_endpoints), by URL: this list's events go there only, signed with that endpoint's secret. An unregistered URL is a 400. Omitted: every endpoint subscribed to each event.

webhook_endpoint_id

string

—

Alternative to webhook_url: the endpoint's id (we_…). Send one or the other.

refresh_every_runs

integer

—

Default pipeline on Amazon: every Nth run sweeps every ASIN at lite instead of pulse (sees buy-box seller changes at the same price; refreshes offer listing ids). 0 = never. A custom pipeline sets this with refresh. From 0 to 1,000.

pipeline

object

—

What each run does. Omitted: the platform default.

pipeline.entry

string

—

The step every run starts with. Default: the first step.

pipeline.baseline

string or null

—

Where items never read before start instead. Default: entry.

pipeline.refresh

object or null

—

Every Nth run starts at this step instead.

pipeline.refresh.every_runs

integer

yes

From 1 to 1,000.

pipeline.refresh.entry

string

yes

—

pipeline.steps

object[]

yes

1 to 10 items.

pipeline.steps[].id

string

yes

—

pipeline.steps[].scraper

string

yes

GET /v1/watchlists/scrapers lists them with their fields. One of: amazon.pulse, amazon.lite, amazon.full, amazon.offers, amazon.offer_check, walmart.standard, target.standard, bestbuy.standard.

pipeline.steps[].condition

string

—

amazon.offers only. One of: all, new, used.

pipeline.steps[].routes

object[]

—

At most 8 items.

pipeline.steps[].routes[].when

string

yes

One of: new, changed, unchanged, ok, failed, not_found, always.

pipeline.steps[].routes[].field

string

—

With changed: only this field counts. With ok: the field op tests.

pipeline.steps[].routes[].op

string

—

One of: increased, decreased, below, above, is, is_not.

pipeline.steps[].routes[].value

number or boolean or string

—

—

pipeline.steps[].routes[].run

string

—

A step id to run next for the matching items.

pipeline.steps[].routes[].notify

boolean

—

Send the matching items (changed: watchlist.product.changed; else watchlist.product.matched).

platform

string

—

Which platform to read. Platforms: amazon (live: us; coming soon: uk, de, fr, it, es, ca, mx, jp, au, in, br, nl, se, pl), walmart (live: us), ebay (coming soon), target (live: us), bestbuy (live: us; coming soon: ca), aliexpress (coming soon). A coming-soon platform or marketplace answers 501 NOT_IMPLEMENTED with "coming_soon": true (nothing charged); an unknown one is a 400 listing the valid values. GET /v1/platforms has the full list. Default amazon.

marketplace

string

—

The platform's regional storefront (us, uk, de…); default the platform's main one. Prices come back in its currency.

201

Created; the first run is due now.

400

MISSING_PARAM or INVALID_PARAM; param names the culprit.

401

UNAUTHORIZED: missing, unknown or revoked key.

403

DEMO_READ_ONLY.

409

CONFLICT: idempotent request in flight, a run already in progress, or a per-account limit.

422

INVALID_PARAM with param: idempotency_key: the key was used for a different request.

429

RATE_LIMITED or CONCURRENCY_LIMIT. Honour Retry-After.

500

INTERNAL: our fault, not charged. Quote X-Request-Id.

id

string

—

object

"watchlist"

—

name

string

—

platform

string

Whose item ids the list holds (id on each item).

marketplace

string

Every run fetches the list here.

currency

string

The currency of every price in its snapshots, changes and webhooks.

status

string

One of: active, paused.

paused_reason

string or null

One of: user, insufficient_credits.

schedule

object or object

When the list runs: a cadence (start to start) or a cron schedule in a time zone.

every

string or null

The cadence of an every-list; null on a cron list (see schedule).

every_seconds

integer or null

The cadence in seconds; null on a cron list.

refresh_every_runs

integer

—

pipeline

object

Up to 10 steps, each running one scraper over the items sent to it; its routes send the items on a branch to another step (run), the webhook (notify), or both. Chains cannot loop.

pipeline.entry

string

The step every run starts with. Default: the first step.

pipeline.baseline

string or null

Where items never read before start instead. Default: entry.

pipeline.refresh

object or null

Every Nth run starts at this step instead.

pipeline.steps

object[]

1 to 10 items.

default_pipeline

boolean

True when the list runs its platform default.

webhook_url

string or null

—

item_count

integer

Items on the list, every state.

items_by_state

object

—

items_by_state.new

integer

—

items_by_state.active

integer

—

items_by_state.delisted

integer

—

asin_count

integer

Deprecated. Deprecated alias, same value as item_count (every platform).

asins_by_state

object

Deprecated. Deprecated alias, same value as items_by_state (every platform).

asins_by_state.new

integer

—

asins_by_state.active

integer

—

asins_by_state.delisted

integer

—

estimated_credits

object

Up-front cost of the next runs: a sweep run with nothing changed (Amazon: pulse), a refresh run, and the one-off baseline fetch of new items (newAsins, on every platform). On Amazon, escalations add lite credits per moved ASIN.

estimated_credits.pulseRun

integer

—

estimated_credits.refreshRun

integer

—

estimated_credits.newAsins

integer

—

run_count

integer

—

consecutive_skips

integer

Runs skipped in a row for credits; the third pauses the list.

last_run_at

string (date-time) or null

—

last_run_status

string or null

One of: running, completed, insufficient_credits, failed.

next_run_at

string (date-time) or null

null while paused.

created_at

string (date-time)

—

updated_at

string (date-time)

—

url

string

—

limit

integer

—

How many lists to return. Default 100. From 1 to 100.

200

Newest first.

401

UNAUTHORIZED: missing, unknown or revoked key.

429

RATE_LIMITED or CONCURRENCY_LIMIT. Honour Retry-After.

500

INTERNAL: our fault, not charged. Quote X-Request-Id.

object

"list"

—

data

object[]

—

data[].id

string

—

data[].object

"watchlist"

—

data[].name

string

—

data[].platform

string

Whose item ids the list holds (id on each item).

data[].marketplace

string

Every run fetches the list here.

data[].currency

string

The currency of every price in its snapshots, changes and webhooks.

data[].status

string

One of: active, paused.

data[].paused_reason

string or null

One of: user, insufficient_credits.

data[].schedule

object or object

When the list runs: a cadence (start to start) or a cron schedule in a time zone.

data[].every

string or null

The cadence of an every-list; null on a cron list (see schedule).

data[].every_seconds

integer or null

The cadence in seconds; null on a cron list.

data[].refresh_every_runs

integer

—

data[].pipeline

object

Up to 10 steps, each running one scraper over the items sent to it; its routes send the items on a branch to another step (run), the webhook (notify), or both. Chains cannot loop.

data[].default_pipeline

boolean

True when the list runs its platform default.

data[].webhook_url

string or null

—

data[].item_count

integer

Items on the list, every state.

data[].items_by_state

object

—

data[].asin_count

integer

Deprecated. Deprecated alias, same value as item_count (every platform).

data[].asins_by_state

object

Deprecated. Deprecated alias, same value as items_by_state (every platform).

data[].estimated_credits

object

Up-front cost of the next runs: a sweep run with nothing changed (Amazon: pulse), a refresh run, and the one-off baseline fetch of new items (newAsins, on every platform). On Amazon, escalations add lite credits per moved ASIN.

data[].run_count

integer

—

data[].consecutive_skips

integer

Runs skipped in a row for credits; the third pauses the list.

data[].last_run_at

string (date-time) or null

—

data[].last_run_status

string or null

One of: running, completed, insufficient_credits, failed.

data[].next_run_at

string (date-time) or null

null while paused.

data[].created_at

string (date-time)

—

data[].updated_at

string (date-time)

—

data[].url

string

—

has_more

boolean

—

id

string

yes

The watchlist id (wl_…).

200

The watchlist, with item counts per state and credit estimates.

401

UNAUTHORIZED: missing, unknown or revoked key.

404

NOT_FOUND.

429

RATE_LIMITED or CONCURRENCY_LIMIT. Honour Retry-After.

500

INTERNAL: our fault, not charged. Quote X-Request-Id.

id

string

—

object

"watchlist"

—

name

string

—

platform

string

Whose item ids the list holds (id on each item).

marketplace

string

Every run fetches the list here.

currency

string

The currency of every price in its snapshots, changes and webhooks.

status

string

One of: active, paused.

paused_reason

string or null

One of: user, insufficient_credits.

schedule

object or object

When the list runs: a cadence (start to start) or a cron schedule in a time zone.

every

string or null

The cadence of an every-list; null on a cron list (see schedule).

every_seconds

integer or null

The cadence in seconds; null on a cron list.

refresh_every_runs

integer

—

pipeline

object

Up to 10 steps, each running one scraper over the items sent to it; its routes send the items on a branch to another step (run), the webhook (notify), or both. Chains cannot loop.

pipeline.entry

string

The step every run starts with. Default: the first step.

pipeline.baseline

string or null

Where items never read before start instead. Default: entry.

pipeline.refresh

object or null

Every Nth run starts at this step instead.

pipeline.steps

object[]

1 to 10 items.

default_pipeline

boolean

True when the list runs its platform default.

webhook_url

string or null

—

item_count

integer

Items on the list, every state.

items_by_state

object

—

items_by_state.new

integer

—

items_by_state.active

integer

—

items_by_state.delisted

integer

—

asin_count

integer

Deprecated. Deprecated alias, same value as item_count (every platform).

asins_by_state

object

Deprecated. Deprecated alias, same value as items_by_state (every platform).

asins_by_state.new

integer

—

asins_by_state.active

integer

—

asins_by_state.delisted

integer

—

estimated_credits

object

Up-front cost of the next runs: a sweep run with nothing changed (Amazon: pulse), a refresh run, and the one-off baseline fetch of new items (newAsins, on every platform). On Amazon, escalations add lite credits per moved ASIN.

estimated_credits.pulseRun

integer

—

estimated_credits.refreshRun

integer

—

estimated_credits.newAsins

integer

—

run_count

integer

—

consecutive_skips

integer

Runs skipped in a row for credits; the third pauses the list.

last_run_at

string (date-time) or null

—

last_run_status

string or null

One of: running, completed, insufficient_credits, failed.

next_run_at

string (date-time) or null

null while paused.

created_at

string (date-time)

—

updated_at

string (date-time)

—

url

string

—

id

string

yes

The watchlist id (wl_…).

name

string

—

Up to 100 characters.

every

string

—

Switch to (or change) a cadence; clears a cron schedule. Send this or cron.

cron

string

—

Switch to (or change) a cron schedule. Standard 5-field cron (minute hour day-of-month month day-of-week) read in timezone: *, lists (1,15), ranges (9-17), steps (*/15, 0-30/10), names (JAN-DEC, SUN-SAT; 0 and 7 are Sunday), and @hourly, @daily, @weekly, @monthly, @yearly. No seconds. When both day fields are restricted a day matches either (Vixie cron). Must not fire more often than every 5 minutes. Across DST a skipped local time runs once, shifted forward by the gap, and a repeated one runs once, at its first occurrence. Send this or every.

timezone

string

—

With cron: its zone (omitted: the list keeps its zone, UTC for a list switching from every). Alone: re-zone an existing cron schedule (400 on an every-list).

webhook_url

string or null

—

A registered endpoint URL; null clears it (events go to every subscribed endpoint).

webhook_endpoint_id

string or null

—

Alternative to webhook_url: a registered endpoint's id.

refresh_every_runs

integer

—

From 0 to 1,000.

pipeline

object or null

—

null goes back to the platform default. Each item keeps what it last showed.

pipeline.entry

string

—

The step every run starts with. Default: the first step.

pipeline.baseline

string or null

—

Where items never read before start instead. Default: entry.

pipeline.refresh

object or null

—

Every Nth run starts at this step instead.

pipeline.refresh.every_runs

integer

yes

From 1 to 1,000.

pipeline.refresh.entry

string

yes

—

pipeline.steps

object[]

yes

1 to 10 items.

pipeline.steps[].id

string

yes

—

pipeline.steps[].scraper

string

yes

GET /v1/watchlists/scrapers lists them with their fields. One of: amazon.pulse, amazon.lite, amazon.full, amazon.offers, amazon.offer_check, walmart.standard, target.standard, bestbuy.standard.

pipeline.steps[].condition

string

—

amazon.offers only. One of: all, new, used.

pipeline.steps[].routes

object[]

—

At most 8 items.

pipeline.steps[].routes[].when

string

yes

One of: new, changed, unchanged, ok, failed, not_found, always.

pipeline.steps[].routes[].field

string

—

With changed: only this field counts. With ok: the field op tests.

pipeline.steps[].routes[].op

string

—

One of: increased, decreased, below, above, is, is_not.

pipeline.steps[].routes[].value

number or boolean or string

—

—

pipeline.steps[].routes[].run

string

—

A step id to run next for the matching items.

pipeline.steps[].routes[].notify

boolean

—

Send the matching items (changed: watchlist.product.changed; else watchlist.product.matched).

status

string

—

Resuming clears an auto-pause and its skip count. One of: active, paused.

200

Updated.

400

MISSING_PARAM or INVALID_PARAM; param names the culprit.

401

UNAUTHORIZED: missing, unknown or revoked key.

404

NOT_FOUND.

429

RATE_LIMITED or CONCURRENCY_LIMIT. Honour Retry-After.

500

INTERNAL: our fault, not charged. Quote X-Request-Id.

id

string

—

object

"watchlist"

—

name

string

—

platform

string

Whose item ids the list holds (id on each item).

marketplace

string

Every run fetches the list here.

currency

string

The currency of every price in its snapshots, changes and webhooks.

status

string

One of: active, paused.

paused_reason

string or null

One of: user, insufficient_credits.

schedule

object or object

When the list runs: a cadence (start to start) or a cron schedule in a time zone.

every

string or null

The cadence of an every-list; null on a cron list (see schedule).

every_seconds

integer or null

The cadence in seconds; null on a cron list.

refresh_every_runs

integer

—

pipeline

object

Up to 10 steps, each running one scraper over the items sent to it; its routes send the items on a branch to another step (run), the webhook (notify), or both. Chains cannot loop.

pipeline.entry

string

The step every run starts with. Default: the first step.

pipeline.baseline

string or null

Where items never read before start instead. Default: entry.

pipeline.refresh

object or null

Every Nth run starts at this step instead.

pipeline.steps

object[]

1 to 10 items.

default_pipeline

boolean

True when the list runs its platform default.

webhook_url

string or null

—

item_count

integer

Items on the list, every state.

items_by_state

object

—

items_by_state.new

integer

—

items_by_state.active

integer

—

items_by_state.delisted

integer

—

asin_count

integer

Deprecated. Deprecated alias, same value as item_count (every platform).

asins_by_state

object

Deprecated. Deprecated alias, same value as items_by_state (every platform).

asins_by_state.new

integer

—

asins_by_state.active

integer

—

asins_by_state.delisted

integer

—

estimated_credits

object

Up-front cost of the next runs: a sweep run with nothing changed (Amazon: pulse), a refresh run, and the one-off baseline fetch of new items (newAsins, on every platform). On Amazon, escalations add lite credits per moved ASIN.

estimated_credits.pulseRun

integer

—

estimated_credits.refreshRun

integer

—

estimated_credits.newAsins

integer

—

run_count

integer

—

consecutive_skips

integer

Runs skipped in a row for credits; the third pauses the list.

last_run_at

string (date-time) or null

—

last_run_status

string or null

One of: running, completed, insufficient_credits, failed.

next_run_at

string (date-time) or null

null while paused.

created_at

string (date-time)

—

updated_at

string (date-time)

—

url

string

—

id

string

yes

The watchlist id (wl_…).

200

Deleted.

401

UNAUTHORIZED: missing, unknown or revoked key.

404

NOT_FOUND.

429

RATE_LIMITED or CONCURRENCY_LIMIT. Honour Retry-After.

500

INTERNAL: our fault, not charged. Quote X-Request-Id.

id

string

—

object

"watchlist"

—

deleted

true

—

id

string

yes

The watchlist id (wl_…).

202

Started.

401

UNAUTHORIZED: missing, unknown or revoked key.

404

NOT_FOUND.

409

CONFLICT: idempotent request in flight, a run already in progress, or a per-account limit.

429

RATE_LIMITED or CONCURRENCY_LIMIT. Honour Retry-After.

500

INTERNAL: our fault, not charged. Quote X-Request-Id.

id

string

—

object

"watchlist_run"

—

watchlist_id

string

—

run_number

integer

—

trigger

string

One of: schedule, manual.

kind

string

sweep: a regular run from the pipeline's entry step. refresh: every Nth run, from the refresh entry (refresh_every_runs). One of: sweep, refresh.

status

string

One of: running, completed, insufficient_credits, failed.

credits

integer

Charged, after refunds.

stats

object or null

—

stats.tracked

integer

—

stats.entry

string

The step the run started from.

stats.new_items

integer

Items read for the first time.

stats.steps

object

Per step that ran, in run order.

stats.matched

integer

Items a notify rule matched on a branch other than changed.

stats.sweep_tier

string

Deprecated. Runs before pipelines. Amazon: pulse, or lite on a refresh run. One-tier platforms: their one tier.

stats.calls

object

Deprecated. Runs before pipelines, keyed by tier.

stats.escalated

object

Deprecated.

stats.deferred

integer

Step items postponed to the next run: the balance could not cover them.

stats.changed

integer

—

stats.delisted

integer

—

stats.retry_next_run

integer

partial + unavailable items (free, retried next run, never a change).

stats.credits_needed

integer

On insufficient_credits: what the run needed up front.

error

string or null

—

started_at

string (date-time)

—

finished_at

string (date-time) or null

—

runs_url

string

—

platform

string

—

The platform whose scrapers to list. Default amazon.

marketplace

string

—

Marks each scraper available or not in this marketplace. Default us.

200

Scrapers and templates.

400

MISSING_PARAM or INVALID_PARAM; param names the culprit.

401

UNAUTHORIZED: missing, unknown or revoked key.

429

RATE_LIMITED or CONCURRENCY_LIMIT. Honour Retry-After.

500

INTERNAL: our fault, not charged. Quote X-Request-Id.

object

"list"

—

platform

string

—

marketplace

string

—

branches

string[]

—

ops

string[]

—

data

object[]

—

data[].id

string

The scraper value of a pipeline step.

data[].name

string

—

data[].description

string

—

data[].credits_per_item

string

A number, or a range such as 1–3 when it depends on the answer.

data[].reads

string

The kind of data it reads; steps of one kind compare with each other. One of: pulse, product, offers, offer_check.

data[].input

string

offer: needs the buy-box offer an earlier product or offers step found. One of: item, offer.

data[].fields

object[]

What rules can test (field).

data[].options

object

Step options, when it has any: condition for amazon.offers.

data[].available

boolean

Can run in marketplace.

templates

object[]

—

templates[].id

string

—

templates[].name

string

—

templates[].description

string

—

templates[].pipeline

object

Up to 10 steps, each running one scraper over the items sent to it; its routes send the items on a branch to another step (run), the webhook (notify), or both. Chains cannot loop.

id

string

yes

The watchlist id (wl_…).

limit

integer

—

How many runs to return. Default 20. From 1 to 100.

200

Runs.

401

UNAUTHORIZED: missing, unknown or revoked key.

404

NOT_FOUND.

429

RATE_LIMITED or CONCURRENCY_LIMIT. Honour Retry-After.

500

INTERNAL: our fault, not charged. Quote X-Request-Id.

object

"list"

—

data

object[]

—

data[].id

string

—

data[].object

"watchlist_run"

—

data[].watchlist_id

string

—

data[].run_number

integer

—

data[].trigger

string

One of: schedule, manual.

data[].kind

string

sweep: a regular run from the pipeline's entry step. refresh: every Nth run, from the refresh entry (refresh_every_runs). One of: sweep, refresh.

data[].status

string

One of: running, completed, insufficient_credits, failed.

data[].credits

integer

Charged, after refunds.

data[].stats

object or null

—

data[].error

string or null

—

data[].started_at

string (date-time)

—

data[].finished_at

string (date-time) or null

—

has_more

boolean

—

id

string

yes

The watchlist id (wl_…).

changed_since

string

—

ISO 8601 or epoch milliseconds.

state

string

—

Only items in this state. One of: new, active, delisted.

limit

integer

—

Items per page. Default 100. From 1 to 1,000.

starting_after

string

—

next_starting_after from the previous page.

200

A page of items.

400

MISSING_PARAM or INVALID_PARAM; param names the culprit.

401

UNAUTHORIZED: missing, unknown or revoked key.

404

NOT_FOUND.

429

RATE_LIMITED or CONCURRENCY_LIMIT. Honour Retry-After.

500

INTERNAL: our fault, not charged. Quote X-Request-Id.

object

"list"

—

platform

string

—

marketplace

string

—

data

object[]

—

data[].id

string

The item's id on the list's platform: an ASIN on Amazon, an item id on Walmart, a TCIN on Target, a SKU on Best Buy.

data[].asin

string

Deprecated. Amazon lists only: the same value as id, kept for clients written before platforms. Absent on every other platform.

data[].state

string

new: waiting for its first (baseline) fetch. delisted: the retailer said not_found; never fetched again (add it again to retry). One of: new, active, delisted.

data[].added_at

string (date-time)

—

data[].last_status

string or null

One of: ok, partial, not_found, unavailable.

data[].pulse

object or null

—

data[].snapshot

object or null

The tracked fields from the last detail fetch, named as in /v1/products results (each platform tracks its own; these are Amazon's). null = the retailer did not say.

data[].snapshot_at

string (date-time) or null

—

data[].snapshot_tier

string or null

The tier the snapshot came from (Amazon: lite or full).

data[].buybox_above_lowest

boolean

The buy box cost more than the lowest new offer at the last fetch, so every run checks it at lite.

data[].pending_standard

boolean

A detail fetch (Amazon: lite) is owed: pulse moved, or the last one failed or was deferred.

data[].changed_at

string (date-time) or null

—

data[].last_change

object or null

—

data[].delisted_at

string (date-time) or null

—

has_more

boolean

—

next_starting_after

string or null

The last id of this page.

id

string

yes

The watchlist id (wl_…).

add

string[]

—

Item ids to add. At most 50,000 items.

remove

string[]

—

Item ids to remove. At most 50,000 items.

200

What changed.

400

MISSING_PARAM or INVALID_PARAM; param names the culprit.

401

UNAUTHORIZED: missing, unknown or revoked key.

404

NOT_FOUND.

429

RATE_LIMITED or CONCURRENCY_LIMIT. Honour Retry-After.

500

INTERNAL: our fault, not charged. Quote X-Request-Id.

id

string

—

object

"watchlist_items"

—

platform

string

—

marketplace

string

—

added

integer

—

reactivated

integer

Delisted items added again.

removed

integer

—

unchanged

integer

Already present (add) or not present (remove).

item_count

integer

—

asin_count

integer

Deprecated. Deprecated alias, same value as item_count.

id

string

yes

The watchlist id (wl_…).

add

string[]

—

Item ids to add. At most 50,000 items.

remove

string[]

—

Item ids to remove. At most 50,000 items.

200

What changed.

400

MISSING_PARAM or INVALID_PARAM; param names the culprit.

401

UNAUTHORIZED: missing, unknown or revoked key.

404

NOT_FOUND.

429

RATE_LIMITED or CONCURRENCY_LIMIT. Honour Retry-After.

500

INTERNAL: our fault, not charged. Quote X-Request-Id.

id

string

—

object

"watchlist_asins"

—

platform

string

—

marketplace

string

—

added

integer

—

reactivated

integer

Delisted items added again.

removed

integer

—

unchanged

integer

Already present (add) or not present (remove).

item_count

integer

—

asin_count

integer

Deprecated. Deprecated alias, same value as item_count.