{"id":"d0c439d3-bb7c-4070-a778-0214ef797366","slug":"apps-apple-com-api","name":"apps.apple.com API","description":"apps.apple.com API","front_facing_description":"Search for applications available on the Apple App Store in China and retrieve detailed information including each app's current version number and file size. This lets you quickly find and compare apps while staying informed about their specifications and storage requirements.","source_url":"https://apps.apple.com/cn/app/","is_authenticated":false,"canonical_scraper_id":"abbb162e-67e3-42a0-b936-851517830481","apis":[{"method":"GET","endpoint_name":"search_apps","description":"Search for apps on the US Apple App Store by keyword. Returns a list of matching apps with metadata including name, version, file size, developer, category, ratings, price, screenshot URLs, and App Store URL. Results are ordered by relevance as determined by the App Store. One upstream request per call; no pagination beyond the limit parameter (max 200).","input_params":{"limit":{"type":"integer","required":false,"description":"Maximum number of results to return (1-200).","default":25,"domain":{"kind":"open","example":"5","pattern":"^[1-9]\\d{0,2}$","generator":{"type":"static","value":"5"}}},"query":{"type":"string","required":false,"description":"Search term for finding apps (e.g. 'instagram', 'weather', 'spotify').","default":"instagram","domain":{"kind":"open","example":"instagram","generator":{"type":"static","value":"instagram"}}}},"return_schema":{"type":"object","fields":{"apps":"Array of app objects with name, version, file size, developer, category, ratings, price, screenshot URLs, and App Store URL","query":"The search term used","result_count":"Number of apps returned"},"sample":{"data":{"apps":[{"price":0.0,"version":"444.0.0","app_name":"Instagram","category":"Photo & Video","icon_url":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/23/59/e9/2359e92d-376c-cc29-b9e6-ab9a4a00fcf4/Prod-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/100x100bb.jpg","track_id":389801252,"bundle_id":"com.burbn.instagram","developer":"Instagram, Inc.","file_size_mb":570.4,"rating_count":29408916,"release_date":"2010-10-06T08:12:41Z","app_store_url":"https://apps.apple.com/us/app/instagram/id389801252?uo=4","average_rating":4.69059,"file_size_bytes":598086656,"formatted_price":"Free","minimum_os_version":"16.3","current_version_release_date":"2026-08-24T13:21:42Z"}],"query":"instagram","result_count":5},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.apps","op":"array_min_len","value":1},{"path":"$.data.apps[*]","op":"field_present","value":"app_name"},{"path":"$.data.apps[*]","op":"field_present","value":"version"},{"path":"$.data.apps[*]","op":"field_present","value":"file_size_bytes"},{"path":"$.data.apps[*]","op":"field_present","value":"screenshot_urls"},{"path":"$.data.apps[*]","op":"field_present","value":"ipad_screenshot_urls"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_app","description":"Get full details for a specific app from the US Apple App Store by numeric ID or App Store URL. Returns comprehensive app information including description, version history (release notes), screenshot URLs, minimum OS version, release date, ratings, file size, and supported devices. The app_id accepts either a numeric ID (e.g. '389801252') or a full App Store URL (e.g. 'https://apps.apple.com/us/app/instagram/id389801252'). The track_id field in search_apps results can be passed directly.","input_params":{"app_id":{"type":"string","required":true,"description":"Numeric App Store ID (e.g. '389801252') or full App Store URL containing the ID (e.g. 'https://apps.apple.com/us/app/instagram/id389801252'). Use track_id from search_apps results.","domain":{"kind":"open","example":"389801252","generator":{"path":"$.data.apps[*].track_id","type":"derived","from_endpoint":"search_apps"}}}},"return_schema":{"type":"object","fields":{"price":"Numeric price (0.0 for free apps)","genres":"Array of genre names","version":"Current version string","app_name":"Name of the app","category":"Primary category","currency":"Currency code (e.g. 'USD')","icon_url":"App icon URL (100x100)","track_id":"Numeric App Store ID","bundle_id":"Bundle identifier","developer":"Developer name","languages":"Array of supported language ISO codes","description":"Full app description text","file_size_mb":"App file size in megabytes","rating_count":"Total number of ratings (all versions)","release_date":"Original release date (ISO 8601)","app_store_url":"App Store URL","developer_url":"Developer website URL","release_notes":"Release notes for the current version (version history)","average_rating":"Average user rating (all versions)","content_rating":"Content advisory rating (e.g. '12+')","file_size_bytes":"App file size in bytes","formatted_price":"Formatted price string (e.g. 'Free', '$0.99')","screenshot_urls":"Array of iPhone screenshot URLs","supported_devices":"Array of supported device identifiers","minimum_os_version":"Minimum iOS version required","ipad_screenshot_urls":"Array of iPad screenshot URLs","current_version_release_date":"Release date of the current version (ISO 8601)","rating_count_current_version":"Number of ratings for current version","average_rating_current_version":"Average user rating for current version"},"sample":{"data":{"price":0.0,"genres":["Photo & Video","Social Networking"],"version":"444.0.0","app_name":"Instagram","category":"Photo & Video","currency":"USD","icon_url":"https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/23/59/e9/2359e92d-376c-cc29-b9e6-ab9a4a00fcf4/Prod-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/100x100bb.jpg","track_id":389801252,"bundle_id":"com.burbn.instagram","developer":"Instagram, Inc.","languages":["BN","HR","CS"],"description":"Little moments lead to big friendships...","file_size_mb":570.4,"rating_count":29408916,"release_date":"2010-10-06T08:12:41Z","app_store_url":"https://apps.apple.com/us/app/instagram/id389801252?uo=4","developer_url":"http://instagram.com/","release_notes":"Performance optimizations and stability improvements.","average_rating":4.69059,"content_rating":"12+","file_size_bytes":598086656,"formatted_price":"Free","screenshot_urls":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/50/e2/8b/50e28b44-daa5-7101-6fb6-2d0e10fc72f3/1_iOS_5.5.jpg/392x696bb.jpg"],"supported_devices":["iPhone5s-iPhone5s","iPadAir-iPadAir"],"minimum_os_version":"16.3","ipad_screenshot_urls":["https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/76/04/4d/76044de8-e420-2e6b-cea4-60821fb85156/10.5__Following_tab.png/360x480bb.jpg"],"current_version_release_date":"2026-08-24T13:21:42Z","rating_count_current_version":29408916,"average_rating_current_version":4.69059},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data","op":"field_present","value":"app_name"},{"path":"$.data","op":"field_present","value":"description"},{"path":"$.data","op":"field_present","value":"version"},{"path":"$.data","op":"field_present","value":"screenshot_urls"},{"path":"$.data","op":"field_present","value":"minimum_os_version"}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"get_app":{"app_id":"389801252"},"search_apps":{"limit":"5","query":"instagram"}},"prefill_inputs":{"search_apps":{"limit":"5","query":"instagram"}},"last_verified_at":"2026-10-29T22:00:26.052344+00:00","endpoint_health":[{"endpoint_name":"search_apps","status":"healthy","last_checked_at":"2026-10-29T22:00:26.052344+00:00","last_verified_at":"2026-10-29T22:00:26.052344+00:00","recent_runs":[{"at":"2026-10-29T22:00:26.052344+00:00","status":"healthy"},{"at":"2026-10-22T19:04:25.738171+00:00","status":"healthy"},{"at":"2026-10-15T10:01:52.887774+00:00","status":"healthy"},{"at":"2026-10-08T10:00:53.153372+00:00","status":"healthy"},{"at":"2026-10-01T09:03:53.799784+00:00","status":"healthy"}]},{"endpoint_name":"get_app","status":"healthy","last_checked_at":"2026-10-29T22:00:26.052344+00:00","last_verified_at":"2026-10-29T22:00:26.052344+00:00","recent_runs":[{"at":"2026-10-29T22:00:26.052344+00:00","status":"healthy"},{"at":"2026-10-22T19:04:25.738171+00:00","status":"healthy"},{"at":"2026-10-15T10:01:52.887774+00:00","status":"healthy"},{"at":"2026-10-08T10:00:53.153372+00:00","status":"healthy"},{"at":"2026-10-01T09:03:53.799784+00:00","status":"healthy"}]}],"sdk_usage_example":{"code":"\"\"\"Walkthrough: Apple App Store SDK — search apps, drill into details.\"\"\"\nfrom parse_apis.apps_apple_com_api import AppStore, AppNotFound\n\nclient = AppStore()\n\n# Search for apps by keyword, cap total items fetched.\nfor app in client.apps.search(query=\"weather\", limit=3):\n    print(app.app_name, app.version, f\"{app.file_size_mb:.1f} MB\")\n\n# Drill down: take the first result and fetch full details by its track_id.\nhit = client.apps.search(query=\"instagram\", limit=1).first()\nif hit is not None:\n    detail = client.apps.get(app_id=str(hit.track_id))\n    print(detail.app_name, detail.version, detail.developer)\n    print(\"Rating:\", detail.average_rating, f\"({detail.rating_count} ratings)\")\n    print(\"Description:\", detail.description[:120])\n\n# Point lookup with typed error handling for a missing app.\ntry:\n    app = client.apps.get(app_id=\"9999999999\")\nexcept AppNotFound as e:\n    print(\"App not found:\", e.message)\n\nprint(\"exercised: apps.search / apps.get\")\n","endpoints":["search_apps","get_app"],"has_session":false,"shape":"parse_sdk","hover_map":[{"line":7,"col":4,"len":3,"label":"app: App","kind":"variable"},{"line":11,"col":0,"len":3,"label":"hit: App","kind":"variable"},{"line":4,"col":9,"len":8,"label":"AppStore — API client","kind":"class"},{"line":7,"col":23,"len":6,"label":"search() → List[App]","kind":"method"},{"line":12,"col":3,"len":3,"label":"hit: App","kind":"variable"},{"line":13,"col":4,"len":6,"label":"detail: App","kind":"variable"},{"line":20,"col":4,"len":3,"label":"app: App","kind":"variable"},{"line":21,"col":7,"len":11,"label":"AppNotFound — error: The requested app ID does not exist on the App Store","kind":"error"},{"line":8,"col":14,"len":8,"label":"app_name: str","kind":"field"},{"line":8,"col":28,"len":7,"label":"version: str","kind":"field"},{"line":13,"col":25,"len":3,"label":"get() → App","kind":"method"},{"line":14,"col":17,"len":8,"label":"app_name: str","kind":"field"},{"line":14,"col":34,"len":7,"label":"version: str","kind":"field"},{"line":14,"col":50,"len":9,"label":"developer: str","kind":"field"},{"line":15,"col":28,"len":14,"label":"average_rating: float","kind":"field"},{"line":20,"col":22,"len":3,"label":"get() → App","kind":"method"},{"line":8,"col":10,"len":3,"label":"app: App","kind":"variable"},{"line":8,"col":24,"len":3,"label":"app: App","kind":"variable"},{"line":11,"col":18,"len":6,"label":"search() → List[App]","kind":"method"},{"line":14,"col":10,"len":6,"label":"detail: App","kind":"variable"},{"line":14,"col":27,"len":6,"label":"detail: App","kind":"variable"},{"line":14,"col":43,"len":6,"label":"detail: App","kind":"variable"},{"line":15,"col":21,"len":6,"label":"detail: App","kind":"variable"},{"line":16,"col":33,"len":11,"label":"description: Optional[str]","kind":"field"},{"line":8,"col":44,"len":12,"label":"file_size_mb: float","kind":"field"},{"line":13,"col":44,"len":8,"label":"track_id: int","kind":"field"},{"line":15,"col":55,"len":12,"label":"rating_count: int","kind":"field"},{"line":16,"col":26,"len":6,"label":"detail: App","kind":"variable"},{"line":22,"col":28,"len":1,"label":"e: AppNotFound","kind":"variable"},{"line":8,"col":40,"len":3,"label":"app: App","kind":"variable"},{"line":13,"col":40,"len":3,"label":"hit: App","kind":"variable"},{"line":15,"col":48,"len":6,"label":"detail: App","kind":"variable"}]},"sdk_delivery_state":"available","summary":"Search for apps on the Apple App Store (China region) and return each app's version and file size information.","updated_at":"2026-08-27T05:13:43.434782+00:00","user_variants":[],"latest_version":3,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"Apple offers the App Store Connect API (https://developer.apple.com/app-store-connect/api/) for developers managing their own apps — it covers sales data, reviews, and submissions for apps you own. There is no public API for searching or fetching metadata on arbitrary third-party apps, which is what this Parse API covers.","q":"Does Apple provide an official developer API for App Store data?"},{"a":"`get_app` returns several fields not present in `search_apps` results: `description`, `release_notes` (the version history text), `screenshot_urls`, `minimum_os_version`, `release_date`, `supported_devices`, and `bundle_id`. Use `search_apps` to find app IDs, then `get_app` to retrieve the full record.","q":"What does `get_app` return beyond what `search_apps` provides?"},{"a":"Both endpoints currently target the US App Store storefront. Apps that are only available in other regional storefronts, or whose pricing differs by region, are not reflected. You can fork this API on Parse and revise it to target a different storefront, such as the China or UK App Store.","q":"Does the API cover App Store regions other than the US?"},{"a":"Not currently. The API returns aggregate ratings data but not individual user review text or review counts by star rating. You can fork this API on Parse and revise it to add a reviews endpoint that fetches per-review content.","q":"Are user reviews or individual review text available through this API?"},{"a":"The data reflects what the App Store currently shows for the given app ID at the time of the request — it is not cached from a static snapshot. Version strings, release notes, and ratings will reflect recent updates as they appear on the live App Store listing.","q":"How fresh is the data returned by `get_app`?"}],"keywords":["apple app store api","app store search api","ios app metadata api","app version file size api","app store app details json","apple app store scraper api","app store ratings and reviews api","get app store app by id api","app store release notes api","ios app bundle id lookup","app store minimum os version api","app store screenshot urls api","app store price tracking api","app store developer apps api","app store category search api"],"use_cases":["Track version changes and release notes for a set of competitor apps using `get_app` on their numeric IDs","Build an app discovery tool that searches by category keyword and surfaces ratings and file size via `search_apps`","Monitor pricing changes across a list of App Store apps by polling `price` and `currency` fields on `get_app`","Compile a dataset of minimum OS requirements and supported devices for app compatibility research","Extract screenshot URLs from `get_app` to display App Store previews in a third-party product catalog","Audit developer portfolios by searching a developer's name and collecting all matching `bundle_id` values","Feed app metadata (name, category, ratings, file size) into a mobile analytics dashboard"],"meta_title":"Apple App Store API – Search & App Details","generated_at":"2026-08-27T05:08:19.631273+00:00","lead_paragraph":"This API provides 2 endpoints for querying Apple App Store data: `search_apps` finds apps by keyword and returns up to 200 results per call with metadata like version, file size, developer, category, ratings, and price, while `get_app` fetches full details for a specific app by numeric ID or App Store URL, including description, release notes, screenshot URLs, minimum OS version, and supported devices.","schema_version":2,"meta_description":"Search the Apple App Store and fetch full app details including version, file size, ratings, price, and release notes via 2 JSON endpoints.","primary_category":"developer_tools","long_description_md":"## Search Apps\n\nThe `search_apps` endpoint accepts a `query` string (e.g. `'spotify'`, `'weather'`, `'photo editor'`) and an optional `limit` integer between 1 and 200. It returns an `apps` array where each object includes the app `name`, current `version`, `file_size`, `developer`, `category`, `ratings`, `price`, and App Store `url`. The `result_count` field tells you how many results were returned. Results are ordered by relevance as the App Store determines it — there is no parameter to change sort order.\n\n## Get App Details\n\nThe `get_app` endpoint takes a single required `app_id` parameter, which can be either a numeric App Store ID (e.g. `'389801252'`) or a full App Store URL containing the ID. It returns a richer set of fields: `app_name`, `bundle_id`, `track_id`, `developer`, `version`, `genres`, `category`, `icon_url` (100×100), `price`, `currency`, `description`, `release_notes` (version history), `screenshot_urls`, `minimum_os_version`, `release_date`, `ratings`, `file_size`, and `supported_devices`.\n\n## Data Coverage\n\nBoth endpoints target the US App Store storefront. Pricing is returned in USD with a `currency` field confirming the code. Free apps return `0.0` for `price`. The `icon_url` field points to a 100×100 image hosted by Apple's CDN. Bundle identifiers (`bundle_id`) are available on `get_app`, useful for cross-referencing apps in MDM systems or analytics pipelines.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["ecommerce","marketplace"]},"primary_category":"developer_tools","secondary_categories":["ecommerce","marketplace"],"access_requirements":[]}