search_products
Search Apple Store pages and products by keyword, model, or part number, then discover sitemap pages or priced accessories with storefront, brand, and price filters.
Instructions
Find sitemap pages by default; use apple_search for Apple search tabs and priced accessories. Sitemap results are not a complete product catalog and do not have variant prices. Apple search filters apply locally to one page.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tab | No | Search tab. 'accessories' returns buyable products with prices; 'explore' returns curated and content results. | explore |
| page | No | Results page, starting at 1. Use next_page to continue. | |
| brand | No | Filter by brand (applied locally). | |
| fresh | No | Bypass the process cache and request current shop data. | |
| query | Yes | Product keywords, model number, or part number. Local-language terms may work best. | |
| source | No | Sitemap page discovery or Apple search results. Sitemap does not contain individual product prices or variants. | sitemap |
| country | No | Storefront country code, e.g. us, de, fr, ch, be. Use list_storefronts for supported values. | us |
| language | No | Shop language; defaults to the country's main language. Switzerland: de/fr; Belgium: fr/nl; Canada: en/fr. | |
| max_price | No | Maximum price in the local currency (applied locally). | |
| min_price | No | Minimum price in the local currency (applied locally). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tab | No | ||
| note | No | ||
| page | Yes | ||
| cache | No | ||
| count | Yes | ||
| query | Yes | ||
| paging | Yes | ||
| source | Yes | ||
| country | No | us | |
| coverage | Yes | ||
| language | No | en | |
| products | Yes | ||
| retailer | Yes | ||
| next_page | Yes | ||
| observed_at | No | ||
| local_filters | No | ||
| related_pages | No | ||
| redirected_url | No | ||
| total_products | Yes |