watchers

WATCHER: get a signed callback when a new US product recall...

WATCHER: get a signed callback when a new US product recall is published (CPSC). Arm once, pay once. Optionally pass keyword to only fire on recalls whose title contains it (e.g. a brand or product). Fires once per new recall (deduped by recall id); bounded by maxFires/expiry. Existing recalls at arm time are baselined. Free public-domain data. Signed (verify offline) + retried; recoverable via watchers.status. Returns a watcherId.

post/api/watchers/product-recall

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/watchers/product-recall
  • Auth: API key in header PAYMENT-SIGNATURE

Request body

keywordstring

Optional: only fire on recalls whose title contains this text (case-insensitive).

callbackUrlstring uri required

Signed event POSTed here (verify X-2s-Signature). Any http(s) URL.

payloadobject

Arbitrary JSON echoed back in every callback.

expiresInSecondsinteger

Active window in seconds (default 30d, max 90d).

maxFiresinteger

Stop after this many recalls (default 25).

labelstring

Optional free-text tag.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.