Create a standing listing alert (email, human-confirmed)

Watch the market for a configuration: a daily email when new matching listings appear. CONSENT CONTRACT: create an alert only for a user who explicitly asked for this alert on this email address. The first alert for a new email is created as pending_confirm and activates only when the email's owner clicks the confirmation link — nothing sends before that, and unconfirmed alerts don't exist for any other purpose. Every alert email carries manage + unsubscribe links. Per-email creation is capped at 5/day. Rate limits: 5/min and 20/day per anonymous IP; 10/min and 40/day with a free key.

post/api/v1/alerts

Request

  • Base URL: https://macfax.com
  • URL: https://macfax.com/api/v1/alerts
  • Auth: one of:
    • none
    • HTTP bearer
    • API key in header X-Api-Key
    • API key in query parameter api_key

Request body

emailstring email required
configstring required

config_key_l0 or _l1

ram_gbinteger
storage_gbinteger
max_price_usdinteger
min_tier'listed' | 'free' | 'premium'
under_typicalboolean

Only listings under the config's typical asking range (p25 gate).

Response

Created — status is active or pending_confirm.

Changes

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