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

Apple

Refract's Apple module runs Apple releases (iPhone launches and restocks) across regions, with shipping or in-store pickup. Apple uses your profiles for checkout, and accounts are optional for most regions.

Get the full product URL

Apple's monitor input is the full product URL of the exact spec you want. Here is how to get it:

1

Spec out the product

Head to apple.com/iphone (or the product's page) and fully spec out the device: size, color, storage, carrier, and so on. Be sure to do this on the Apple domain for your region.

2

Copy the final URL

Once you reach the final spec page, copy the URL from the address bar. A full URL looks like:

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

Paste it as the monitor input

That full URL is your task group's monitor input. Anything less than the final spec-page URL will not work.

Task Group Setup

Create a task group for the Apple region you are running (see Task Group Creation). Apple's group settings are the simplest of any site:

An Apple US task group settings panel
Apple's group settings: the full product URL, a proxy list, and the delay.
Setting
Value
Notes

Monitor Input

The full product URL

See above

Monitor Proxy List

Your proxy list

Monitor Delay

3500 (default)

Task Creation

Click + in the task group to open Create Tasks.

The Apple Create Tasks window
Restart on Failure stays ON. Accounts are optional for Apple US.
Setting
Value
Notes

Profiles

Your Profile Group

Task Proxy List

Your proxy list

Leave blank for localhost

Match account to profiles (by email)

Optional

Pairs accounts to profiles with the same email

Accounts

Optional

Required for some regions, not recommended for Apple US

Restart on Failure

ON (default)

Tasks automatically restart after a failure instead of stopping

Use Account Shipping

OFF

Ships to the address saved inside the Apple account

Use Account Billing

OFF

Uses the billing address saved inside the Apple account

Apply Account Balance

OFF

Uses the gift card balance on the account

Use Fastest Delivery ($$)

OFF

Checks out with the fastest delivery option, often at a premium charge

In-Store Pickup

OFF

Purchases for in-store pickup. See below

Business Name (optional)

Blank

Only if you are registered with Apple as an official business

Retry Delay

3500 (default)

Task Qty

1

Tasks per profile

Item Quantity

1

A ceiling, not an exact number: the task goes for the max it can get, up to what you set. See How Item Quantity works

In-Store Pickup options

With In-Store Pickup on, you configure where the bot looks for stores:

  • Max Distance: how many miles from the ZIP code the bot searches for stores.

  • Use Store From Profile Zip: searches for stores within the max distance of the profile's ZIP code.

  • Choose Store: enter a custom ZIP and manually pick individual stores. Useful when running out of state or targeting specific stores.

Stores not populating? Either your local IP is banned or it is just slow to load; give it 30 seconds. If the Apple waiting room page is live, store data cannot be fetched at all, so use the billing ZIP and search radius to determine stores when creating tasks during that window.

Accounts (optional)

Add Apple accounts via the Accounts guide if your region needs them. The first time you start a task with an account, Apple sends a code to your Apple devices. Enter it in the 2FA codes window when it pops up, or set up IMAP to submit codes automatically.

Running an Apple release

  • The bot handles Apple's queue. Tasks may enter Apple's waiting room, and that is expected. Seeing "Rate Limit" while Apple gradually lets users in over the first 5-10 minutes of a release is normal.

  • Start tasks 10-15 seconds before drop time.

  • Shipping tasks are the reliable play on launch day. They are not subject to the same out-of-stock issues as pickup and typically check out successfully around the clock during a release. The variable is the delivery date, which slips further out as stock depletes.

  • Pickup tasks keep working after the drop. Restocks occur over the days following an initial drop, so keep pickup tasks running.

Forced Delivery

"Forced Delivery" means Apple's fraud detection blocked your pickup option. The cause varies (profiles, accounts, or proxy IPs) and there is no definitive way to determine the exact reason for each setup. You can keep running pickup tasks anyway and catch the restocks over the following days.

Proxies

ISP/DC proxies are generally recommended for Apple. However, Apple temporarily bans or rate-limits these proxies when used for extended periods, so a combination of ISP/DC and residential can help. Expect an increase in proxy bans either way.

FAQ

Will the bot adjust quantity if Apple's max is lower than what I set?

Yes. If you request 4 units and Apple allows 2, the bot automatically goes for 2.

Can I still run pickup tasks if I see Forced Delivery?

Yes. Keep them running; restocks occur over the days after the initial drop. Just be aware that ISP proxies often get blocked after extended use.

Last updated

Was this helpful?