Apple App Store Product API

The API for fetching full Apple App Store product details by App Store ID. Built for AI agents, MCP clients, ASO tools, and product research.

Pass any Apple App Store ID (or App Store URL) and get back a complete, structured product record: title, developer, description, version history, price, ratings and rating distribution, screenshots, in-app purchases, supported languages, privacy cards, and sample reviews. Works across 50+ country stores. One API call, one App Store ID, one rich JSON record.

This API is fully MCP (Model Context Protocol) ready with one-click setup for Claude Code, Claude Cowork, and Claude.ai Chat. AI agents can discover it, call it, and chain it with the rest of the Apple App Store API family without glue code.

---

AI Agent and MCP Integration

The fastest path to use this API is through the Apify MCP server. Once connected, Claude or any other MCP-compatible AI agent can discover this API and invoke it directly from a natural-language prompt. No SDK, no manual REST plumbing, no client glue.

The Apify MCP server hosts three discovery tools (search-actors, fetch-actor-details, add-actor) that let agents find this API on the fly and register it as a callable tool. Pick the setup that matches your Claude surface.

Option 1: Claude Code (terminal CLI)

The single-command setup. Open your terminal and run:

$claude mcp add apify -- npx -y @apify/actors-mcp-server

Then add your Apify API token (one time):

$claude mcp add apify -e APIFY_TOKEN=your_apify_token_here -- npx -y @apify/actors-mcp-server

Get your token at https://console.apify.com/account/integrations.

Prefer to edit config by hand? Open ~/.claude.json and add:

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server"],
      "env": { "APIFY_TOKEN": "your_apify_token_here" }
    }
  }
}

Restart Claude Code, then try a prompt like:

Use the Apple App Store Product API to get full details for Spotify (App Store ID 324684580) in the US store.

Claude will discover this API via search-actors, register it as a tool, and call it.

Option 2: Claude Cowork (web)

Claude Cowork uses the hosted Apify MCP endpoint over HTTP. No local install required.

1. Open Cowork.
2. Go to Settings > Connectors > Add custom connector.
3. Fill in:
   • Name: Apify
   • Remote MCP URL: https://mcp.apify.com
   • Authentication: Bearer token (paste your Apify API token).
4. Save and enable the connector.

Once connected, the Apify tools appear in the tool drawer. Try a prompt:

Use the App Store product API to get full details for these App Store URLs: https://apps.apple.com/us/app/spotify/id324684580 and https://apps.apple.com/us/app/duolingo/id570060128. Compare their ratings and pricing.

Cowork supports dynamic tool discovery, so once Claude finds this API in a session, it stays registered as a named tool for the rest of the conversation. Subsequent prompts reuse it without re-discovery.

Option 3: Claude.ai Chat (Connectors)

Same hosted MCP endpoint, configured through the standard Claude.ai UI.

1. Open https://claude.ai.
2. Click your profile, then Settings > Connectors > Add custom connector.
3. Fill in:
   • Name: Apify
   • Remote MCP URL: https://mcp.apify.com
   • Authentication: Bearer token (your Apify API token).
4. Save. Toggle the connector on at the start of any chat where you want App Store product data.

Then prompt as normal:

Use the Apple App Store product API on Apify to fetch the full product page for Spotify in the UK store. Show version history and supported languages.

Option 4: Direct REST API (ChatGPT, n8n, Zapier, custom GPTs)

Skip MCP entirely with a single REST API call. Useful for custom GPT actions, Zapier flows, n8n pipelines, or any HTTP client.

curl -X POST \
  "https://api.apify.com/v2/acts/YOUR_USERNAME~apple-app-store-product/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"product_ids": ["324684580"], "country": "us"}'

For ChatGPT custom GPT actions, import the Apify OpenAPI spec as a custom action. Once added, ChatGPT can call this API from any custom GPT.

Full Apify MCP documentation

MCP Discovery Phrases

These are the natural-language phrasings an AI agent is likely to use when it searches for a tool that solves "fetch full Apple App Store product details." If you are building or evaluating an agent, you can pre-warm tool selection by including any of these in your system prompt or tool catalog. They are also the phrasings we tune actor.json to rank on for the Apify MCP search-actors discovery tool.

• "Apple App Store product API"
• "iOS app details API by App Store ID"
• "App Store metadata API"
• "Apple App Store app information API"
• "API to fetch App Store app details, pricing, screenshots"
• "iOS app version history API"
• "Apple App Store sample reviews API"
• "App Store privacy and data disclosures API"
• "Apple App Store in-app purchases lookup API"

Chained-Workflow Example: search then fetch

This API is designed to compose with the Apple App Store Search API. A typical agent workflow:

Use the App Store search API to find "meditation" apps in the US store, take the top 3 results, then use the App Store product API to fetch full details (version history, screenshots, IAPs, privacy cards) for each. Summarize the differences.

Both APIs share the same app_id key, so the agent can hand the IDs straight from the search call into the product call. See The Apple App Store API Family below for the full integration map.

---

What You Can Extract

Every dataset item is one App Store product, flat and ready for analysis.

Field	Description
app_id	Numeric App Store ID.
title	Official app title shown on the App Store.
snippet	Short tagline.
developer_name, developer_link	Developer name and App Store developer page URL.
age_rating	Content rating (e.g. 4+, 12+).
rating_average, rating_count	Average star rating and total rating count.
rating_distribution	Breakdown of ratings into 1-star through 5-star buckets.
price_text	Displayed price string (e.g. Get, $2.99).
in_app_purchases_available	Boolean indicator of whether IAPs are offered.
logo	Logo / icon URL.
description_text	Full long-form app description.
iphone_screenshots, ipad_screenshots	Arrays of screenshot links with sizes.
version_history	Array of {release_version, release_notes, release_date} entries.
review_examples	Sample user reviews shown on the product page: rating, username, date, title, text, and any developer reply.
privacy_description, privacy_policy_link, privacy_cards	Apple privacy disclosures and the developer's privacy policy URL.
seller, copyright	Legal entity behind the app and copyright text.
size_text	App size as displayed on the store (e.g. 759.4 MB).
category	Primary App Store category.
compatibility	Per-device-class compatibility entries (iPhone, iPad, Mac, etc.) with OS requirements.
supported_languages_text	Comma-separated list of supported languages.
in_app_purchases	Array of {name, price} IAP entries.
supports	Features the app supports (Family Sharing, Siri, Wallet, etc.).
featured_in	Editorial placements.
you_may_also_like, more_by_this_developer	Recommendation lists (optional, off by default).
link	Direct apps.apple.com URL for the product.
lookup_country, lookup_timestamp	Echo of the country store queried and ISO timestamp.

---

The Apple App Store API Family

This API is the middle link in a three-API family, all keyed on the same app_id:

API	Purpose	Input	Output
Apple App Store Search API	Find apps by keyword.	Search term + country	Many apps (search results).
Apple App Store Product API (this API)	Get full details for one app.	One or more App Store IDs + country	One full product record per ID.
Apple App Store Reviews API (coming soon)	Get paginated reviews for one app.	App Store ID + country + sort	Many reviews per app.

Search API ──► app_id ──► Product API ──► full product details
                     └──► Reviews API ──► paginated reviews

Agents typically chain them: search for candidates, pick the IDs they care about, then fan out to the product API and the reviews API. Pricing is per-record across the family, so you only pay for what you actually fetch.

---

Use Cases

• AI agent context: Feed real App Store product data into LLM prompts for grounded answers about iOS apps.
• Competitive product research: Compare two or more apps side-by-side on pricing, IAPs, screenshots, version cadence, and supported languages.
• ASO deep dives: Inspect the full long-form description, release notes cadence, and screenshot order for top-ranked apps in a category.
• Pricing intelligence: Snapshot price, IAP catalog, and price-localization across multiple country stores for the same app.
• Version history audit: Watch a rival app's release cadence and notes over time.
• Privacy and data disclosure research: Pull structured privacy cards to study what data developers declare collecting.
• Editorial placement tracking: See which apps are currently featured by Apple's editorial team and what placements they hold.
• Recommendation graph mining: Crawl you_may_also_like to map app affinities (when include_related_apps is on).

---

Input Parameters

Parameter	Type	Required	Default	Description
product_ids	array of strings	yes	(none)	One or more App Store IDs or App Store URLs. Each entry yields one dataset row. Min 1, max 100 per run.
country	string	no	us	Two-letter country code (ISO 3166-1 alpha-2, lowercase). 50+ stores supported.
include_reviews_sample	boolean	no	true	Include the sample reviews Apple shows on the product page. Set false to slim the row.
include_related_apps	boolean	no	false	Include you_may_also_like and more_by_this_developer recommendation lists.
output_file	string	no	auto	Optional local JSON filename. Used for local development only.

---

Example Inputs

Single app by numeric ID

{
  "product_ids": ["324684580"]
}

Single app via App Store URL

{
  "product_ids": ["https://apps.apple.com/us/app/spotify/id324684580"]
}

The API parses the ID out of the URL automatically.

Batch lookup

{
  "product_ids": [
    "324684580",
    "570060128",
    "https://apps.apple.com/us/app/notion/id1232780281"
  ],
  "country": "us"
}

Localized store (UK)

{
  "product_ids": ["324684580"],
  "country": "gb"
}

Slim output (no sample reviews, no related apps)

{
  "product_ids": ["324684580"],
  "include_reviews_sample": false,
  "include_related_apps": false
}

Full output (everything on)

{
  "product_ids": ["324684580"],
  "include_reviews_sample": true,
  "include_related_apps": true
}

---

Example API Output

Each dataset item is one App Store product:

{
  "app_id": 324684580,
  "title": "Spotify: Music and Podcasts",
  "snippet": "Songs & Playlists For You",
  "developer_name": "Spotify",
  "developer_link": "https://apps.apple.com/us/developer/spotify/id324684583",
  "age_rating": "12+",
  "rating_average": 4.8,
  "price_text": "Get",
  "logo": "https://...logo.png",
  "description_text": "With Spotify, you can listen to music and play millions of songs and podcasts for free...",
  "iphone_screenshots": [
    {"link": "https://...iphone1.png", "size": "1284x2778"}
  ],
  "ipad_screenshots": [
    {"link": "https://...ipad1.png", "size": "2048x2732"}
  ],
  "version_history": [
    {"release_version": "9.0.40", "release_notes": "We're always making changes and improvements to Spotify...", "release_date": "2026-05-05"}
  ],
  "rating_distribution": {
    "5_star": 35028124,
    "4_star": 2780888,
    "3_star": 854840,
    "2_star": 312515,
    "1_star": 799640
  },
  "review_examples": [
    {
      "rating": "5",
      "username": "MusicLover88",
      "review_date": "04/15/2026",
      "review_title": "Best music app",
      "review_text": "I have been using Spotify for years and the discovery features keep getting better...",
      "response_text": null
    }
  ],
  "privacy_description": "The developer indicated that the app's privacy practices may include...",
  "privacy_policy_link": "https://www.spotify.com/legal/privacy-policy/",
  "privacy_cards": [
    {"title": "Data Used to Track You", "description": "...", "categories": ["Identifiers", "Usage Data"]}
  ],
  "seller": "Spotify",
  "size_text": "264.1 MB",
  "category": "Music",
  "compatibility": [
    {"device": "iPhone", "requirement": "Requires iOS 15.0 or later"}
  ],
  "supported_languages_text": "English, French, German, Japanese, Korean, Spanish",
  "copyright": "© 2026 Spotify AB",
  "supports": [
    {"title": "Family Sharing", "description": "Up to six family members can use this app..."}
  ],
  "featured_in": [],
  "link": "https://apps.apple.com/us/app/id324684580",
  "lookup_country": "us",
  "lookup_timestamp": "2026-05-12T04:32:20"
}

---

Pricing

Transparent pay-per-event API call pricing. You only pay for products you actually fetch.

Event	Cost	When charged
setup	$0.02	Once at the start of each run.
result	$0.02	Per App Store product returned.

Cost estimates

Use case	Products returned	Approx. cost
One app lookup	1	$0.04
Batch of 10 apps	10	$0.22
Batch of 50 apps	50	$1.02
Batch of 100 apps (per-run cap)	100	$2.02

No monthly subscription. No hidden fees. Stop the run at any time and pay only for what was already returned.

---

How to Get Started

1. Create an Apify account at https://apify.com if you do not have one.
2. Open the actor page on the Apify store and click Try for free.
3. Set the input (only product_ids is required) and click Start.
4. Watch the run live in the Apify console, then download results as JSON, CSV, Excel, or RSS once it finishes.
5. Optional: connect via MCP (see top of this README) to call the API directly from Claude or any AI agent.

---

FAQ

Q: What counts as a valid product_id? A: Any numeric Apple App Store ID (e.g. 324684580) or any App Store URL that contains /id<digits> (e.g. https://apps.apple.com/us/app/spotify/id324684580). The API parses the ID out of URLs automatically.

Q: Can I get all the reviews for an app? A: This API returns the sample reviews Apple shows on the product page (typically three). For full paginated reviews, use the dedicated Apple App Store Reviews API (coming soon in this family). Both APIs share the same app_id, so you can chain them.

Q: Can I look up Apple Music tracks, podcasts, or movies with this API? A: Not in v1. This API focuses on the app product type. Music, podcasts, and movies can be added in v2 if there is demand - file a feature request on the actor page.

Q: Does the same App Store ID return different data in different countries? A: Yes. Price, availability, localized text, and the sample reviews are all country-dependent. Set country to query the right regional store. Run the same ID across multiple country values to compare.

Q: What happens if I pass an invalid ID or a URL the API cannot parse? A: That entry is skipped with an error record pushed to the dataset, and the other entries in the batch continue. The setup fee is still charged once, but no result fee is charged for the failed entry.

Q: How do I batch fetch many apps? A: Pass an array of up to 100 IDs in product_ids. Each entry is fetched sequentially with a short delay to be polite to the upstream. Each successful fetch is one result charge.

Q: Does this work with AI agents and MCP? A: Yes. Setup instructions for Claude Code, Claude Cowork, and Claude.ai Chat are at the top of this README. The API surface, parameter names, and output shape are tuned for natural-language tool discovery.

Q: Which country stores are supported? A: 50+ stores including US, UK, CA, AU, DE, FR, JP, KR, BR, MX, IN, and more. See the country parameter dropdown for the full list.

---

Last Updated: 2026.05.17