For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

What each site takes as monitor input

Site
Monitor input
Example

Amazon

ASIN

B0DYNN7RTT

Walmart

PID (the number in the URL)

walmart.com/ip/d/165545420165545420

Target

TCIN (the number in the URL)

target.com/p/-/A-8111459581114595

Best Buy

SKU (from the bottom of the product page)

6537363

Apple

Full product URL (the final spec page)

https://www.apple.com/shop/buy-iphone/iphone-17-pro/6.9-inch-display-256gb-silver-unlocked


In-Bot Monitor & Checkout Feed

You do not have to find monitor inputs yourself. The bot has a built-in feed of what the monitors are picking up, on every site.

Click the monitor (computer screen) icon in the top right of the bot to open the popup. It has two tabs: Monitor, the live feed of products being picked up, and Checkout Feed. Use the filter at the top to narrow the feed to a site, for example Walmart on a Wednesday.

The in-bot monitor feed popup with Monitor and Checkout Feed tabs
The feed popup. Filter it to the site you are running.

Right-click any product in the feed for three options:

  • Set product to group: hover it and pick a task group. The product goes straight into that group's monitor input, no copying and pasting.

  • Copy monitor input: copies the input so you can paste it into your task groups yourself.

  • Copy product link: copies the product page URL.

The right-click menu on a feed product
Set product to group puts the input straight into a task group.

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, until that product goes out of stock (OOS).

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

Multi Input is great for most restocks. However, when multiple products drop simultaneously, all tasks will go for the first product detected, then move on only after it’s OOS - potentially missing other products that dropped at the same time. To target all items at once, run separate Single Input groups. Although you can use the same accounts, proxies, and profiles across groups, this does increases ban risk.

  • 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.

How does the monitor delay work with Multi Input monitoring?

When you run Multi Input with a monitor delay (e.g., 2000 ms), the bot checks all inputs in the list concurrently, re-checking them at that same monitor delay interval.

  • Every input in the list is monitored at the same time.

  • The delay (2000 ms) applies to the entire batch, not each monitor input individually.

  • With a 2000 ms delay, all products are monitored every 2 seconds, no matter how many inputs you’ve added to your list.

In other words, the bot doesn’t cycle down the list. All items are covered simultaneously on the interval you set.

Since all products in a Multi Input list are monitored concurrently, your bot traffic to the site scales with the number of inputs, thus increasing the likelihood for monitor rate limits/bans.

To avoid bans or blocks, plan for at least 1 proxy per input in your list. Ideally, use more than a 1:1 ratio to spread out the monitor traffic load and to help ensure stable monitoring.

Multi Input Formatting

Each product gets its own line. For example:

  • 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.

Price max works on every site except Best Buy and Apple. Target included: run Target multi-SKU with a price cap per line as tcin;price_max, exactly like other sites. Best Buy and Apple are the only sites that do not support price max.

Example:

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?