app-store-scraper

# App Store Scraper

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.

## Quick Start

**Tools Required:**
- `curl` for HTTP requests
- `jq` for JSON parsing and formatting

**Example:**
```bash
# Get app details
curl -s "https://itunes.apple.com/lookup?id=553834731&entity=software" | \
  jq '.results[0] | {name: .trackName, rating: .averageUserRating}'
```

## Decision Trees

Use these decision trees to quickly find the right endpoint for your needs.

### 🎯 Decision Tree 1: What Data Do You Need?

```
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)
```

### 🔍 Decision Tree 2: How Do You Identify the App?

```
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