Account

Email the person when an item drops to their price

Live

POST https://shopitup.ca/api/v1/price-alerts

A price-drop alert: ShopItUp emails the person once when the item's price is target_price or less, then the alert ends. It never buys and holds nothing — whoever checks out first gets the item. Only for stores that offer alerts. Asking again for the same item moves the person's alert to the new price. Lasts up to 30 days (days). Refused, among others, with already_at_price when the item is already at or under target_price, store_has_no_price_alerts, too_many_alerts (25), item_unavailable, email_not_verified.

Access: alerts:write How to get a token
Returns: The price-drop alert

Request

curl -X POST "https://shopitup.ca/api/v1/price-alerts" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "catalog_item_id": "5171",
    "target_price": 90
  }'

const response = await fetch("https://shopitup.ca/api/v1/price-alerts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "catalog_item_id": "5171",
    "target_price": 90
  }),
});

const data = await response.json();

import requests

response = requests.post(
    "https://shopitup.ca/api/v1/price-alerts",
    headers={"Authorization": f"Bearer {token}"},
    json={
      "catalog_item_id": "5171",
      "target_price": 90
    },
)

data = response.json()

Response

201 · The price-drop alert

{
  "price_alert_id": 7,
  "status": "active",
  "catalog_item_id": "5171",
  "title": "(S) Arc'teryx Casual Cozy Outdoor Gray Fleece Turtleneck Pullover",
  "target_price": {
    "amount": "90.00",
    "currency": "CAD"
  },
  "current_price": {
    "amount": "110.00",
    "currency": "CAD"
  },
  "notified_at": null,
  "expires_at": "2026-11-08T18:00:00Z",
  "created_at": "2026-10-09T18:00:00Z"
}

422 · The request is invalid; `fields` says which field and why

{
  "error": {
    "code": "validation_failed",
    "message": "The request is invalid. See fields for what to fix.",
    "fields": {
      "per_page": [
        "The per page field must not be greater than 48."
      ]
    }
  }
}

401 · Missing, invalid or expired access token

{
  "error": {
    "code": "unauthorized",
    "message": "The access token is missing, invalid or expired."
  }
}

403 · The token does not carry the scope this endpoint needs

{
  "error": {
    "code": "insufficient_scope",
    "message": "This request needs a token with the catalog:read scope."
  }
}

429 · Too many requests; retry after the number of seconds in `Retry-After`

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again in 30 seconds."
  }
}

503 · A service the API depends on is briefly unavailable; retry after the number of seconds in `Retry-After`

{
  "error": {
    "code": "unavailable",
    "message": "A service the API depends on is briefly unavailable. Try again in a few seconds."
  }
}

Request body

JSON, sent with Content-Type: application/json.

catalog_item_id string Required
target_price number Required

Email the person when the item's price is this or less (before shipping and tax).
days integer

1–30

Response

201 The price-drop alert

price_alert_id integer
status string

One of active notified cancelled expired item_sold
catalog_item_id string
title string
target_price Money
2 child attributes
- amount string Required
  
  Decimal string, two places
- currency string Required
  
  One of CAD
current_price Money
2 child attributes
- amount string Required
  
  Decimal string, two places
- currency string Required
  
  One of CAD
notified_at string date-time

When the person was emailed that the price reached their target.
expires_at string date-time
created_at string date-time

Status codes

201

The price-drop alert

409

Refused; no alert was set

422

The request is invalid; fields says which field and why

401

Missing, invalid or expired access token

403

The token does not carry the scope this endpoint needs

429

Too many requests; retry after the number of seconds in Retry-After

503

A service the API depends on is briefly unavailable; retry after the number of seconds in Retry-After

Errors share one shape — see Errors and rate limits.