Search Apple App Store
⚠️ Apple devices only. This endpoint searches Apple's App Store for apps available for deployment to Apple-managed devices.
Searches the Apple App Store by app title (required), returning matching app records with metadata including icon, bundle ID, file size, App Store URL, minimum OS version, release date, and seller name.
About Search Apple App Store
This endpoint proxies a title-based search against Apple's App Store, enabling integrators to discover apps by name before adding them to Esper for deployment. Unlike GET /api/v2/itunesapps, which retrieves metadata for apps already in Esper's system, this endpoint queries the App Store directly and does not require the app to already exist in the tenant library. Results include the bundle_id needed to identify the app in subsequent VPP or deployment workflows. This is a discovery tool — app installation and deployment are handled through VPP licensing and blueprint or operation endpoints.
Key Query Parameters / Fields
title (required) — App title search string
name (response) — App name as listed in the App Store
bundle_id (response) — Bundle identifier (e.g., com.apple.mobilesafari); use this in VPP and deployment workflows
icon (response) — URL for the app's icon
app_store_url (response) — Direct link to the app's App Store listing
minimum_os (response) — Minimum iOS version required
file_size_in_bytes (response) — App binary size in bytes
release_date (response) — App release date in ISO 8601 format
seller_name (response) — App developer or publisher name
Common Use Cases
Searching for an app by name to retrieve its bundle_id before configuring a VPP install or blueprint Verifying minimum OS version compatibility before targeting a specific iOS device group Confirming app availability and publisher identity before adding it to the tenant's VPP library
Best Practices
Use specific, well-formed title strings — broad or partial searches may return large result sets; use the bundle_id from results to uniquely identify the target app
Verify minimum_os against the OS versions in your device fleet before targeting an app for deployment
This endpoint is for discovery only — use VPP licensing endpoints and blueprint or operation endpoints to configure and deploy the app
Query parameters
Response
Success
Example response
{
"content": {
"results": [
{
"icon": "https://icon-url.com",
"name": "Safari",
"bundle_id": "com.apple.mobilesafari",
"file_size_in_bytes": "100",
"app_store_url": "https://apps.apple.com/us/app/",
"minimum_os": "10.0",
"release_date": "2021-10-25T07:00:00.000Z",
"seller_name": "Apple Inc."
}
]
}
}