Monitor Setup & Multi Input

Monitor Inputs

Monitor inputs are the values Refract uses when searching a site to ensure you are getting the right product. These are configured in the Monitoring section of your task group.

There are three accepted input types, and which one to use depends on the site:

  1. PID (Product ID)

    • A product-specific identifier used by the site.

    • Commonly used on Amazon, BestBuy, Target, and Walmart.

  2. Direct Link (URL)

    • A full product URL that points directly to the item.

    • Supported by many sites where PIDs or OIDs are not available like Apple.

  3. OID (Offer ID)

    • A unique string of numbers/letters tied to a specific offer for a product.

    • Allows for faster ATC (add-to-cart) than PID or direct link.

    • Only supported on Amazon and Walmart.

    • We recommend using OIDs provided by your cook group or monitors.


Multi Input

Refract also supports Multi Input, which lets you monitor multiple products within a single task group.

  • All tasks in the group will go for the first product picked up.

  • Once that product goes out of stock (OOS), tasks will automatically move to the next product in the list at the next monitor ping.

  • Multi Input is NOT “Multi Cart.” Refract does not support multi-cart checkouts (carting multiple products and checking them out in the same order). Instead, Multi Input lets you monitor multiple products within a single task group and automatically shift between them.

  • Works on every site except Walmart queue drops.

Multi Input Formatting

Each product gets its own line. For example:

pid1
pid2;max_price
pid3;max_price;oid
pid4;oid
pid5
  • Use semicolons (;) to separate values.

  • pid = Product ID (required)

  • max_price = Optional max price threshold.

  • oid = Offer ID (only for Amazon and Walmart).

Not every product needs a max_price or oid. Include them only when needed.

Example:

B09XYZ123
B08LMN456;399
B07QRS789;499;k0l3ysA%2BeL5Ujfp%2FT.....
B0DYNN7RTT;6ewE64HlEkbBskr%2FYwVREz.....

This setup means:

  • Monitor product B09XYZ123 with no price limit.

  • Monitor product B08LMN456 but only if ≤ $399.

  • Monitor product B07QRS789 with a $499 cap, while also monitoring a specific OID for Amazon/Walmart.

    • When using an OID, Refract monitors both the PID and OID together. Always set a max price to avoid accidentally checking out third-party or overpriced listings.

Last updated

Was this helpful?