メニュー
WHEN scraping iOS/macOS App Store data (apps, reviews, ratings, search); NOT for installing or testing apps; retrieves structured JSON data using iTunes/App Store APIs with curl and jq formatting
Comprehensive guide for implementing on-device AI models on iOS using Foundation Models and MLX Swift frameworks. Use WHEN building iOS apps with (1) Local LLM inference, (2) Vision Language Models (VLMs), (3) Text embeddings, (4) Image generation, (5) Tool/function calling, (6) Multi-turn conversations, (7) Custom model integration, or (8) Structured generation.
WHEN building ChatGPT apps using the OpenAI Apps SDK and MCP; create conversational, composable experiences with proper UX, UI, state management, and server patterns.
WHEN building SwiftUI views, managing state, setting up shared services, or making architectural decisions; NOT for UIKit or legacy patterns; provides pure SwiftUI data flow without ViewModels using @State, @Binding, @Observable, and @Environment.
WHEN building design systems or component libraries with Tailwind CSS; covers design tokens, CVA patterns and dark mode.
WHEN building React components/pages/apps; enforces scalable architecture, state management, API layer, performance patterns.
Evidence-based goal achievement framework using Goal, Plan, and System methodology. Use when users want to set goals, create actionable plans, build execution systems, or diagnose why they're struggling to make progress on existing goals. Triggers include requests to "set a goal", "help me achieve", "create a plan", "why am I not making progress", or similar goal-setting and achievement queries.
| name | app-store-scraper |
| description | WHEN scraping iOS/macOS App Store data (apps, reviews, ratings, search); NOT for installing or testing apps; retrieves structured JSON data using iTunes/App Store APIs with curl and jq formatting |
Comprehensive toolkit for retrieving structured data from Apple's App Store and iTunes APIs using curl and jq. All endpoints return JSON that can be parsed and formatted for analysis.
Tools Required:
curl for HTTP requestsjq for JSON parsing and formattingExample:
# Get app details
curl -s "https://itunes.apple.com/lookup?id=553834731&entity=software" | \
jq '.results[0] | {name: .trackName, rating: .averageUserRating}'
Use these decision trees to quickly find the right endpoint for your needs.
What information do you need?
│
├─ App Metadata (name, price, developer, description)
│ ├─ I know the app ID → [App Lookup](endpoints/app-lookup.md)
│ ├─ I know the bundle ID → [App Lookup](endpoints/app-lookup.md)
│ └─ I need to search by keyword → [App Search](endpoints/search.md)
│
├─ App Discovery
│ ├─ Browse top apps or categories → [App Lists/Feeds](endpoints/lists.md)
│ ├─ Search by keyword → [App Search](endpoints/search.md)
│ ├─ Find all apps by a developer → [Developer Apps](endpoints/developer.md)
│ ├─ Get search suggestions → [Search Suggestions](endpoints/suggestions.md)
│ └─ Find similar apps → [Similar Apps](endpoints/similar.md)
│
└─ User Feedback
├─ Read user reviews → [Reviews](endpoints/reviews.md)
└─ Get rating distribution (1-5 stars) → [Ratings Histogram](endpoints/ratings.md)
How do you identify the app?
│
├─ I have the numeric app ID (e.g., 553834731)
│ ├─ Get app details → [App Lookup](endpoints/app-lookup.md)
│ ├─ Get reviews → [Reviews](endpoints/reviews.md)
│ ├─ Get ratings breakdown → [Ratings Histogram](endpoints/ratings.md)
│ └─ Find similar apps → [Similar Apps](endpoints/similar.md)
│
├─ I have the bundle ID (e.g., com.apple.Numbers)
│ └─ Get app details → [App Lookup](endpoints/app-lookup.md)
│
├─ I have the developer ID
│ └─ Get all apps by developer → [Developer Apps](endpoints/developer.md)
│
├─ I only know the app name
│ └─ Search by keyword → [App Search](endpoints/search.md)
│
└─ I want to explore
├─ Browse by category → [App Lists/Feeds](endpoints/lists.md)
└─ Get search suggestions → [Search Suggestions](endpoints/suggestions.md)
What do you want to do?
│
├─ Analyze a Specific App
│ ├─ Get comprehensive metadata → [App Lookup](endpoints/app-lookup.md)
│ ├─ Read user feedback → [Reviews](endpoints/reviews.md)
│ ├─ Analyze rating distribution → [Ratings Histogram](endpoints/ratings.md)
│ └─ Find competitors/alternatives → [Similar Apps](endpoints/similar.md)
│
├─ Market Research
│ ├─ Track top apps in categories → [App Lists/Feeds](endpoints/lists.md)
│ ├─ Analyze developer portfolios → [Developer Apps](endpoints/developer.md)
│ └─ Search by keyword/category → [App Search](endpoints/search.md)
│
└─ Monitor Changes
├─ Track rating changes → [Ratings Histogram](endpoints/ratings.md)
├─ Monitor new reviews → [Reviews](endpoints/reviews.md)
└─ Watch top charts → [App Lists/Feeds](endpoints/lists.md)
Do you need region-specific or multi-app data?
│
├─ Multi-Region Analysis
│ ├─ Compare ratings across regions → [Ratings Histogram](endpoints/ratings.md)
│ └─ Get reviews from different regions → [Reviews](endpoints/reviews.md)
│
├─ Bulk Operations
│ ├─ Lookup multiple apps → [App Lookup](endpoints/app-lookup.md)
│ └─ Search and filter results → [App Search](endpoints/search.md)
│
└─ Category Browsing
└─ Browse by specific categories → [App Lists/Feeds](endpoints/lists.md)
Reliable, structured API endpoints that return JSON:
| Endpoint | Description | File |
|---|---|---|
| App Lookup | Get detailed app info by ID or bundle ID | endpoints/app-lookup.md |
| App Search | Search apps by keyword with filters | endpoints/search.md |
| App Lists/Feeds | Browse top apps and categories | endpoints/lists.md |
| Developer Apps | Get all apps by a specific developer | endpoints/developer.md |
| Reviews | Fetch paginated user reviews | endpoints/reviews.md |
| Ratings Histogram | Get 1-5 star rating breakdown | endpoints/ratings.md |
| Search Suggestions | Get autocomplete search hints | endpoints/suggestions.md |
Requires HTML parsing, less reliable:
| Endpoint | Description | File |
|---|---|---|
| Similar Apps | Find related apps (web scraping) | endpoints/similar.md |
# 1. Search for competitor apps
curl -s "https://itunes.apple.com/search?term=note%20taking&media=software&entity=software&limit=10"
# 2. Get detailed info for top results
# 3. Compare ratings, features, pricing
# 4. Analyze user reviews
See: [App Search](endpoints/search.md) → [App Lookup](endpoints/app-lookup.md) → [Reviews](endpoints/reviews.md)
# 1. Get current app state
# 2. Track rating changes over time
# 3. Monitor new reviews
# 4. Alert on rating drops
See: [App Lookup](endpoints/app-lookup.md) → [Ratings Histogram](endpoints/ratings.md) → [Reviews](endpoints/reviews.md)
# 1. Browse top apps in category
# 2. Analyze pricing trends
# 3. Study feature patterns
# 4. Identify gaps in market
See: [App Lists/Feeds](endpoints/lists.md) → [App Search](endpoints/search.md)
# 1. Find developer ID from an app
# 2. Get all apps by developer
# 3. Compare performance across portfolio
# 4. Track developer strategy
See: [App Lookup](endpoints/app-lookup.md) → [Developer Apps](endpoints/developer.md)
us)software for appsen-US, ja-JP)| Code | Country | Code | Country |
|---|---|---|---|
us | United States | gb | United Kingdom |
de | Germany | fr | France |
jp | Japan | au | Australia |
ca | Canada | es | Spain |
it | Italy | br | Brazil |
in | India | mx | Mexico |
kr | South Korea | cn | China |
# Get app by ID
curl -s "https://itunes.apple.com/lookup?id=553834731&entity=software" | jq '.results[0]'
# Search apps
curl -s "https://itunes.apple.com/search?term=weather&media=software&entity=software&limit=10"
# Top free apps
curl -s "https://itunes.apple.com/us/rss/topfreeapplications/limit=25/json"
# Recent reviews
curl -s "https://itunes.apple.com/us/rss/customerreviews/page=1/id=553834731/sortby=mostrecent/json"
jq emptyStart Here: Use the decision trees above to find the right endpoint for your needs, then follow the links to detailed documentation.