> For the complete documentation index, see [llms.txt](https://help.refractbot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.refractbot.com/modules/apple.md).
# 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:
{% stepper %}
{% step %}
#### Spec out the product
Head to [apple.com/iphone](https://www.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.
{% endstep %}
{% step %}
#### 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
```
{% endstep %}
{% step %}
#### 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.
{% endstep %}
{% endstepper %}
## Task Group Setup
Create a task group for the Apple region you are running (see [Task Group Creation](/general-setup/task-creation/task-group-creation.md)). Apple's group settings are the simplest of any site:
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.
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` | If Apple's max is lower than what you set, the bot goes for the max allowed |
### 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.
{% hint style="info" %}
**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.
{% endhint %}
## Accounts (optional)
Add Apple accounts via the [Accounts guide](/general-setup/accounts.md) 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](/general-setup/settings.md#2fa-codes) when it pops up, or set up [IMAP](/misc./imap.md) 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
What are the recommended steps for a new user running Apple?
1. Add profiles.
2. Add proxies.
3. Optional: add accounts.
4. Create a task group with the full product URL and create tasks.
5. Start tasks 10-15 seconds before drop time.
6. Monitor announcements for updates.
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.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.refractbot.com/modules/apple.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.