Apple MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Apple: 32 typed functions through one MCP server. No Apple API key needed.
- Site
- apple.com
- Functions
- 32
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Apple alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/appleOne MCP server for Apple and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
checkCoverageLook up what warranty or AppleCare a device still has from its serial number.Arguments
Name Type Required serialstringYes Returns
AppleCoverageResultinterface AppleCoverageResult { serial: string; found: boolean; errorToken?: string; raw?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/checkCoverageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.checkCoverage("F2LN3AB1JCL7");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.checkCoverage("F2LN3AB1JCL7"))curl -X POST https://api.bowmark.ai/v1/sites/apple/checkCoverage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"serial":"F2LN3AB1JCL7"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.checkCoverage("F2LN3AB1JCL7");compareModelsPut two or more models of the SAME family.Arguments
Name Type Required modelsstring[]Yes Returns
AppleCompareModelsinterface AppleCompareSpec { label: string; value: string; } interface AppleCompareModel { name: string; specs: AppleCompareSpec[]; } interface AppleCompareModels { models: AppleCompareModel[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/compareModelsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.compareModels(["iPhone 17 Pro", "iPhone 17"]);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.compareModels(["iPhone 17 Pro", "iPhone 17"]))curl -X POST https://api.bowmark.ai/v1/sites/apple/compareModels \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"models":["iPhone 17 Pro","iPhone 17"]}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.compareModels(["iPhone 17 Pro", "iPhone 17"]);findStoresNearFind the Apple Stores near a place a person named.Arguments
Name Type Required placestringYes Returns
AppleStoresNearinterface AppleNearbyStore { storeNumber: string; storeName: string; city: string; state: string; address: string; phoneNumber: string; distanceMiles: number | null; } interface AppleStoresNear { location: string; stores: AppleNearbyStore[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/findStoresNearCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.findStoresNear("cupertino");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.findStoresNear("cupertino"))curl -X POST https://api.bowmark.ai/v1/sites/apple/findStoresNear \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"place":"cupertino"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.findStoresNear("cupertino");getBagWhat's in the shopping bag right now, no sign-in needed.Arguments
None.
Returns
AppleBagContentsinterface AppleBagContents { hasItems: boolean; raw: unknown; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getBagCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getBag();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getBag())curl -X POST https://api.bowmark.ai/v1/sites/apple/getBag \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getBag();getConfigurationOptionsRead every choice a buy page actually offers.Arguments
Name Type Required urlOrPathstringYes Returns
AppleConfigurationOptionsinterface AppleConfigChoice { key: string; label: string; } interface AppleConfigDimension { key: string; label: string; choices: AppleConfigChoice[]; } interface AppleConfiguration { dimensions: Record<string, string>; partNumber: string | null; buildToOrder: boolean; price: number | null; priceCurrency: string | null; } interface AppleConfigurationOptions { url: string; dimensions: AppleConfigDimension[]; configDimensions: AppleConfigDimension[]; configurations: AppleConfiguration[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getConfigurationOptionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getConfigurationOptions("/shop/buy-mac/macbook-air");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getConfigurationOptions("/shop/buy-mac/macbook-air"))curl -X POST https://api.bowmark.ai/v1/sites/apple/getConfigurationOptions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlOrPath":"/shop/buy-mac/macbook-air"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getConfigurationOptions("/shop/buy-mac/macbook-air");getDeliveryEstimateWhen would this actually arrive if I ordered it now, to my ZIP code.Arguments
Name Type Required partNumberstringYes postalCodestringYes Returns
AppleDeliveryEstimateinterface AppleDeliveryOption { displayName: string; date: string; shippingCost: string; } interface AppleDeliveryEstimate { partNumber: string; postalCode: string; options: AppleDeliveryOption[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getDeliveryEstimateCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getDeliveryEstimate("MYAP3LL/A", "94301");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getDeliveryEstimate("MYAP3LL/A", "94301"))curl -X POST https://api.bowmark.ai/v1/sites/apple/getDeliveryEstimate \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"partNumber":"MYAP3LL/A","postalCode":"94301"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getDeliveryEstimate("MYAP3LL/A", "94301");getNewsroomPostRead one Apple press release in full from its URL.Arguments
Name Type Required urlstringYes Returns
AppleNewsroomArticleinterface AppleNewsroomArticle { title: string; summary: string; date: string; url: string; body: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getNewsroomPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getNewsroomPost("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getNewsroomPost("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/apple/getNewsroomPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"<url>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getNewsroomPost("<url>");getOrderStatusWhere is one Apple order, and when does it arrive.Arguments
Name Type Required orderNumberstringYes Returns
AppleOrderStatusinterface AppleOrderStatus { orderNumber: string; raw: unknown; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getOrderStatusCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getOrderStatus("W000000000");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getOrderStatus("W000000000"))curl -X POST https://api.bowmark.ai/v1/sites/apple/getOrderStatus \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"orderNumber":"W000000000"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getOrderStatus("W000000000");getPickupAvailabilityAnswer the one question apple.com is uniquely able to answer and no other site can: can I walk into a store today and pick this up.Arguments
Name Type Required partNumberstringYes placestringYes Returns
ApplePickupAvailabilityinterface ApplePickupStore { storeNumber: string; storeName: string; city: string; state: string; address: string; phoneNumber: string; distanceMiles: number | null; available: boolean; pickupQuote: string | null; } interface ApplePickupAvailability { partNumber: string; location: string; stores: ApplePickupStore[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getPickupAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getPickupAvailability("MYAP3LL/A", "94301");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getPickupAvailability("MYAP3LL/A", "94301"))curl -X POST https://api.bowmark.ai/v1/sites/apple/getPickupAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"partNumber":"MYAP3LL/A","place":"94301"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getPickupAvailability("MYAP3LL/A", "94301");getProductReads one apple.com product/buy page (a URL or path search already returned, e.g. /shop/buy-iphone/iphone-16) and returns every schema.org Product…Arguments
Name Type Required urlOrPathstringYes Returns
AppleProductPageinterface AppleProduct { name: string; lowPrice: number | null; highPrice: number | null; priceCurrency: string | null; image: string | null; description: string | null; partNumber: string | null; } interface AppleProductPage { url: string; products: AppleProduct[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getProduct("/shop/buy-iphone/iphone-16");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getProduct("/shop/buy-iphone/iphone-16"))curl -X POST https://api.bowmark.ai/v1/sites/apple/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlOrPath":"/shop/buy-iphone/iphone-16"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getProduct("/shop/buy-iphone/iphone-16");getProductByPartNumberTurn an Apple part number, the MYAP3LL/A-shaped code printed on every buy page, in every pickup and delivery answer, and on the box, into the product…Arguments
Name Type Required partNumberstringYes Returns
AppleProductPageinterface AppleProduct { name: string; lowPrice: number | null; highPrice: number | null; priceCurrency: string | null; image: string | null; description: string | null; partNumber: string | null; } interface AppleProductPage { url: string; products: AppleProduct[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getProductByPartNumberCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getProductByPartNumber("MYAP3LL/A");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getProductByPartNumber("MYAP3LL/A"))curl -X POST https://api.bowmark.ai/v1/sites/apple/getProductByPartNumber \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"partNumber":"MYAP3LL/A"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getProductByPartNumber("MYAP3LL/A");getPurchaseOptionsRead the ways Apple will let you pay for one product.Arguments
Name Type Required urlOrPathstringYes Returns
ApplePurchaseOptionsinterface ApplePurchaseOptionTerm { id: string; name: string; sectionHeader: string; sectionFooter: string; } interface ApplePurchaseOption { id: string; formValue: string; sectionHeader: string; sectionFooter: string; hideCarrier: boolean; terms: ApplePurchaseOptionTerm[]; } interface ApplePurchaseOptions { url: string; options: ApplePurchaseOption[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getPurchaseOptionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getPurchaseOptions("/shop/buy-mac/macbook-air");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getPurchaseOptions("/shop/buy-mac/macbook-air"))curl -X POST https://api.bowmark.ai/v1/sites/apple/getPurchaseOptions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlOrPath":"/shop/buy-mac/macbook-air"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getPurchaseOptions("/shop/buy-mac/macbook-air");getRepairPricingWhat Apple charges to fix an iPhone, iPad or Apple Watch.Arguments
Name Type Required device"iphone" | "ipad" | "watch"Yes Returns
AppleRepairPricinginterface AppleRepairService { label: string; price: string; } interface AppleRepairModelPricing { model: string; outOfWarranty: AppleRepairService[]; appleCarePlus: AppleRepairService[]; } interface AppleRepairPricing { device: "iphone" | "ipad" | "watch"; helpUrl: string | null; models: AppleRepairModelPricing[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getRepairPricingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getRepairPricing("iphone");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getRepairPricing("iphone"))curl -X POST https://api.bowmark.ai/v1/sites/apple/getRepairPricing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"device":"iphone"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getRepairPricing("iphone");getStoreRead one Apple Store: its full address, phone number, map coordinates, store number and the hours it is open each day of the week.Arguments
Name Type Required urlOrPathstringYes Returns
AppleStoreinterface AppleStoreHours { days: string[]; opens: string; closes: string; } interface AppleStore { storeNumber: string; name: string; url: string; phoneNumber: string; address: string; city: string; state: string; postalCode: string; latitude: number | null; longitude: number | null; hours: AppleStoreHours[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getStoreCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getStore("/retail/thesummit/");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getStore("/retail/thesummit/"))curl -X POST https://api.bowmark.ai/v1/sites/apple/getStore \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlOrPath":"/retail/thesummit/"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getStore("/retail/thesummit/");getSupportArticleRead one Apple support article end to end.Arguments
Name Type Required docidOrUrlstringYes Returns
AppleSupportArticleinterface AppleSupportArticle { docid: string; title: string; description: string; url: string; body: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getSupportArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getSupportArticle("102640");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getSupportArticle("102640"))curl -X POST https://api.bowmark.ai/v1/sites/apple/getSupportArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"docidOrUrl":"102640"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getSupportArticle("102640");getSystemStatusIs App Store / iCloud / FaceTime / Apple Music down right now, or is it me.Arguments
Name Type Required scope"consumer" | "developer"No Returns
AppleSystemStatusinterface AppleSystemEvent { messageId: string; statusType: string; message: string; eventStatus: "resolved" | "completed" | string; epochStartDate: number; epochEndDate: number; } interface AppleSystemServiceStatus { serviceName: string; redirectUrl: string | null; status: "operational" | "ongoing" | "recent"; hasEvent: boolean; events: AppleSystemEvent[]; } interface AppleSystemStatus { scope: "consumer" | "developer"; drMessage: string | null; services: AppleSystemServiceStatus[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getSystemStatusCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getSystemStatus();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getSystemStatus())curl -X POST https://api.bowmark.ai/v1/sites/apple/getSystemStatus \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getSystemStatus();getTradeInEstimateReads apple.com's own trade-in value table and returns the ceiling ("up to $X") cash-or-credit estimate it publishes for one iPhone model.Arguments
Name Type Required modelstringYes Returns
AppleTradeInEstimateinterface AppleTradeInEstimate { device: string; upToUsd: number; sourceUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/getTradeInEstimateCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.getTradeInEstimate("iPhone 14 Pro");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.getTradeInEstimate("iPhone 14 Pro"))curl -X POST https://api.bowmark.ai/v1/sites/apple/getTradeInEstimate \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"iPhone 14 Pro"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.getTradeInEstimate("iPhone 14 Pro");listAccessoriesEverything Apple sells that is not a device.Arguments
Name Type Required category"cases-protection" | "chargers-adapters" | "headphones-speakers" | "drives-storage" | "mice-keyboards" | "gaming" | "office" | "travel-essentials" | "college-essentials" | "software" | "homekit" | "content-creation" | "health-fitness" | "new-arrivals" | "made-by-apple" | "accessibility"Yes pagenumberNo Returns
AppleAccessoryCataloginterface AppleAccessoryListing { partNumber: string; name: string; price: number | null; priceCurrency: string | null; url: string; image: string | null; } interface AppleAccessoryCatalog { category: | "cases-protection" | "chargers-adapters" | "headphones-speakers" | "drives-storage" | "mice-keyboards" | "gaming" | "office" | "travel-essentials" | "college-essentials" | "software" | "homekit" | "content-creation" | "health-fitness" | "new-arrivals" | "made-by-apple" | "accessibility"; page: number; hasMore: boolean; listings: AppleAccessoryListing[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/listAccessoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.listAccessories("cases-protection");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.listAccessories("cases-protection"))curl -X POST https://api.bowmark.ai/v1/sites/apple/listAccessories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"category":"cases-protection"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.listAccessories("cases-protection");listFamilyModelsList every model Apple currently sells in one product family.Arguments
Name Type Required family"mac" | "iphone" | "ipad" | "watch"Yes Returns
AppleFamilyModelListinterface AppleFamilyModel { name: string; startingPrice: number | null; url: string; } interface AppleFamilyModelList { family: "mac" | "iphone" | "ipad" | "watch"; models: AppleFamilyModel[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/listFamilyModelsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.listFamilyModels("mac");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.listFamilyModels("mac"))curl -X POST https://api.bowmark.ai/v1/sites/apple/listFamilyModels \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"family":"mac"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.listFamilyModels("mac");listNewsroomPostsApple's official announcements, newest first.Arguments
None.
Returns
AppleNewsroomPostListinterface AppleNewsroomPost { title: string; category: string; date: string; url: string; summary: string; } interface AppleNewsroomPostList { posts: AppleNewsroomPost[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/listNewsroomPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.listNewsroomPosts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.listNewsroomPosts())curl -X POST https://api.bowmark.ai/v1/sites/apple/listNewsroomPosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.listNewsroomPosts();listOrdersEverything I have bought from Apple, with dates and prices.Arguments
None.
Returns
AppleOrderListinterface AppleOrderList { rootKey: string; raw: unknown; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/listOrdersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.listOrders();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.listOrders())curl -X POST https://api.bowmark.ai/v1/sites/apple/listOrders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.listOrders();listRefurbishedApple's own certified refurbished store, read as data: every listing currently in stock in one category.Arguments
Name Type Required category"mac" | "ipad" | "iphone" | "watch" | "appletv" | "homepod" | "airpods" | "accessories"Yes Returns
AppleRefurbishedCataloginterface AppleRefurbishedListing { partNumber: string; name: string; price: number | null; priceCurrency: string | null; url: string; image: string | null; } interface AppleRefurbishedCatalog { category: "mac" | "ipad" | "iphone" | "watch" | "appletv" | "homepod" | "airpods" | "accessories"; listings: AppleRefurbishedListing[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/listRefurbishedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.listRefurbished("mac");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.listRefurbished("mac"))curl -X POST https://api.bowmark.ai/v1/sites/apple/listRefurbished \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"category":"mac"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.listRefurbished("mac");listStoresEvery Apple Store in the US on one call.Arguments
None.
Returns
AppleStoreListinterface AppleStoreListing { storeNumber: string; name: string; url: string; } interface AppleStoreList { stores: AppleStoreListing[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/listStoresCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.listStores();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.listStores())curl -X POST https://api.bowmark.ai/v1/sites/apple/listStores \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.listStores();listTodaySessionsThe free Today at Apple sessions one store is running.Arguments
Name Type Required storeSlugOrUrlstringYes Returns
AppleTodaySessionListinterface AppleTodaySession { sessionId: string; title: string; prefix: string; description: string; startTime: string; endTime: string; timeZone: string; status: string; // the site's own labels, read the values off a result, never guess one from prose storeNum: string; storeName: string; icalUrl: string; } interface AppleTodaySessionList { storeSlug: string; sessions: AppleTodaySession[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/listTodaySessionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.listTodaySessions("unionsquare");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.listTodaySessions("unionsquare"))curl -X POST https://api.bowmark.ai/v1/sites/apple/listTodaySessions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"storeSlugOrUrl":"unionsquare"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.listTodaySessions("unionsquare");listTradeInValuesThe whole Apple Trade In price list in one call. "smartphone" is the rich catalogue behind the estimator.Arguments
Name Type Required category"smartphone" | "computer" | "watch"Yes Returns
AppleTradeInCataloginterface AppleTradeInDeviceValue { modelId: string | null; modelName: string; maxValueUsd: number; } interface AppleTradeInCatalog { category: "smartphone" | "computer" | "watch"; devices: AppleTradeInDeviceValue[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/listTradeInValuesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.listTradeInValues("smartphone");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.listTradeInValues("smartphone"))curl -X POST https://api.bowmark.ai/v1/sites/apple/listTradeInValues \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"category":"smartphone"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.listTradeInValues("smartphone");resolveLocationTurn the place a person said.Arguments
Name Type Required placestringYes Returns
AppleResolvedLocationinterface AppleLocationSuggestion { displayValue: string; city: string; state: string; } interface AppleResolvedLocation { place: string; location: string; city: string; state: string; alternates: AppleLocationSuggestion[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/resolveLocationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.resolveLocation("cupertino");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.resolveLocation("cupertino"))curl -X POST https://api.bowmark.ai/v1/sites/apple/resolveLocation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"place":"cupertino"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.resolveLocation("cupertino");searchSearches apple.com's own site search for a keyword, returning the organic and curated result rows it renders server-side.Arguments
Name Type Required querystringYes Returns
AppleSearchResponseinterface AppleSearchResult { kind: "organic" | "curated"; title: string; description: string | null; url: string | null; links?: Array<{ label: string; url: string }>; } interface AppleSearchResponse { query: string; results: AppleSearchResult[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.search("iphone");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.search("iphone"))curl -X POST https://api.bowmark.ai/v1/sites/apple/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"iphone"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.search("iphone");searchSupportSearch Apple's own support library the way a person describes a problem.Arguments
Name Type Required querystringYes Returns
AppleSupportSearchResponseinterface AppleSupportResult { docid: string; title: string; url: string; snippet: string; } interface AppleSupportSearchResponse { query: string; results: AppleSupportResult[]; totalResults: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/searchSupportCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.searchSupport("iphone battery draining");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.searchSupport("iphone battery draining"))curl -X POST https://api.bowmark.ai/v1/sites/apple/searchSupport \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"iphone battery draining"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.searchSupport("iphone battery draining");suggestSearchesType the first two letters of what you want.Arguments
Name Type Required querystringYes Returns
AppleSuggestResponseinterface AppleSuggestionRow { label: string; url: string; } interface AppleSuggestResponse { query: string; suggestions: AppleSuggestionRow[]; quickLinks: AppleSuggestionRow[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/suggestSearchesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.suggestSearches("airpo");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.suggestSearches("airpo"))curl -X POST https://api.bowmark.ai/v1/sites/apple/suggestSearches \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"airpo"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.suggestSearches("airpo");
addToBagAdd a product to the shopping bag (cart) by part number.Arguments
Name Type Required partstringYes atbtokenstringYes apiKeystringYes storefrontstringYes optionsRecord<string, unknown>No Returns
AppleAddToBagResultinterface AppleAddToBagResult { addedToBag: boolean; bagQuantity?: number; errorCode?: string; message?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/addToBagCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.addToBag({ part: "<part>", atbtoken: "<atbtoken>", apiKey: "<apiKey>", storefront: "<storefront>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.addToBag({ "part": "<part>", "atbtoken": "<atbtoken>", "apiKey": "<apiKey>", "storefront": "<storefront>" }))curl -X POST https://api.bowmark.ai/v1/sites/apple/addToBag \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"request":{"part":"<part>","atbtoken":"<atbtoken>","apiKey":"<apiKey>","storefront":"<storefront>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.addToBag({ part: "<part>", atbtoken: "<atbtoken>", apiKey: "<apiKey>", storefront: "<storefront>" });bookGeniusBarAppointmentSubmit a Genius Bar / repair reservation's confirmation step.Arguments
Name Type Required request{ locale: string; authToken: string; body: Record<string, unknown> }Yes Returns
AppleGeniusBarBookingResultinterface AppleGeniusBarBookingResult { raw: unknown; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/bookGeniusBarAppointmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.bookGeniusBarAppointment({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.bookGeniusBarAppointment({}))curl -X POST https://api.bowmark.ai/v1/sites/apple/bookGeniusBarAppointment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"request":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.bookGeniusBarAppointment({});removeFromBagRemove an item from the shopping bag by its UUID.Arguments
Name Type Required itemUuidstringYes csrfTokenstringYes Returns
AppleRemoveFromBagResultinterface AppleRemoveFromBagResult { success: boolean; message?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/apple/removeFromBagCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apple.removeFromBag({ itemUuid: "<itemUuid>", csrfToken: "<csrfToken>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apple.removeFromBag({"itemUuid": "<itemUuid>", "csrfToken": "<csrfToken>"}))curl -X POST https://api.bowmark.ai/v1/sites/apple/removeFromBag \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"request":{"itemUuid":"<itemUuid>","csrfToken":"<csrfToken>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.apple.removeFromBag({ itemUuid: "<itemUuid>", csrfToken: "<csrfToken>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/apple/<function> - OpenAPI
/v1/sites/apple/openapi.json