--- title: "Track Create" method: POST path: "/v1/track" --- # Track Create `POST /v1/track` ## Request - Base URL: `https://api.logimu.com` (the document declares no server; this is the origin it was published from) - URL: `https://api.logimu.com/v1/track` - Auth: none declared TRACK a product (2026-10-14): pin an ASIN into our hot lane so its all-offers page is re-read every 2 / 4 / 12 / 24 hours (hourly too) for as long as the plan is active - or ttl_days if you set one. Every read becomes a point in the product's buybox_price_points_hot (price, buy-box seller, fulfillment, offer count), so GET /v1/product - and its 0.05-credit history_only lane, or a product batch with source: "tracked" - carries sub-daily buy box, price and offer-count history for it. 0 credits. What a plan sells is a daily ALLOWANCE of tracked snapshots: Solo 2,500 (e.g. 416 products every 4 hours), Starter 6,000, Growth 18,000, Standard 40,000, Scale 170,000, Volume 710,000. When the allowance is spent the call answers 402 tracking_allowance_full with the upgrade link; when only a longer interval fits, that interval is granted and the answer says so (granted_interval). Posting the same ASIN again renews it and sets the new interval (same id). A lapsed subscription keeps its trackings 7 days, then they pause and resume by themselves when the subscription returns. Alerts: webhook_url + notify_if (signed POSTs) and / or alert_email (one e-mail per event, 50 a day per tracking). The lane picks a new tracking up within ~10 minutes (pending: true until then); one fetch serves every account tracking the same ASIN. ## Headers - `x-api-key` string, nullable - `authorization` string, nullable ## Request body - TrackRequest - `asin` string, nullable: The product's 10-character Amazon ASIN. Or give a list: items / asins (P87, 2026-10-14). - `items` union[], nullable: Bulk (2026-10-14): up to 1,000 trackings in one call, each an object {asin, country?, interval?, ttl_days?, notify_if?, webhook_url?, alert_email?} or just the ASIN string; the top-level fields are the defaults for every item. results[] comes back in input order with created / renewed / refused / invalid per item; the allowance is consumed in input order and the call is never all-or-nothing. - union - object - string - `asins` string[], nullable: Bulk shorthand: a list of ASINs, all with the top-level fields. - `country` string: Amazon marketplace: us, uk, de, ca, au, fr, it, es, jp, mx, br (amazon-xx accepted). Amazon only - no Walmart. - `interval` string: How often the lane re-reads the all-offers page: 1h, 2h, 4h (default), 12h or 24h. A shorter interval draws more of the daily allowance (1h = 24 snapshots a day, 2h = 12, 4h = 6, 12h = 2, 24h = 1). - `ttl_days` integer, nullable: Optional: stop after this many days (1-365). Omit (or 0) and the tracking runs for as long as the plan is active; a lapsed plan keeps it 7 days, then it pauses and resumes with the plan. - `alert_email` union: Optional (2026-10-14): e-mail alerts for the notify_if thresholds - true for the account's own address, or an address. One e-mail per event, at most 50 a day per tracking, from noreply@logimu.com. false (or "") detaches; omit to keep. Works with or without webhook_url. - string - boolean - `webhook_url` string, nullable: Optional (2026-10-14): an https URL we POST to when a notify_if threshold fires on a new observation of the product (signed X-Logimu-Signature: sha256=HMAC-SHA256(secret, raw_body); the secret is returned once). Send an empty string to detach; omit to keep. - `notify_if` object, nullable: With webhook_url: the thresholds - price_below, price_above (a price), price_change_pct (a percent move since the previous observation), buybox_seller_change (true), offer_count_below / offer_count_above (a count), availability_change (true). {} attaches the webhook and fires on nothing. ## Response `200` Successful Response - unknown ## Other responses - `422`: Validation Error --- [API](https://skmtc.dev/logimu/apis/logimu-api.md) · [All operations](https://skmtc.dev/logimu/apis/logimu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/logimu/apis/logimu-api/revisions/3d3f90ad2335?raw)