100 free credits. No credit card required

App Store App List API

Name: App Store App List API
Brand: SocialCrawl
Availability: InStock

Scrape App Store App List data with one API call. Returns a unified AppList for an Apple App Store chart (top free, top paid, top grossing, and the three new-apps charts), optionally scoped to a category. Each item is the same canonical `App` shape as app-search. Use it to track ranking movements or build a category leaderboard. iPad-specific charts are not available from this source. Apple publishes a chart for most but not all categories: the Newsstand-era `magazines_*` values plus `catalogs`, `games_dice` and `games_educational` return an empty list on `top_free_ios` at 0 credits (measured 06/09/2026), and several of them do populate on the `new_ios` charts.

Last updated September 2026Maintained by the SocialCrawl team

Start for free View Documentation

Returns an Apple App Store chart such as top free, top paid, top grossing for iPhone or iPad, or new apps, with the same app fields as app-search.

Use it to track ranking movements or build a category leaderboard, rather than searching for one named app.

Searching 65 platforms in parallel

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·

Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Yelp·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·

Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·

Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Yelp·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·

Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·

Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Yelp·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·

Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·

Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Yelp·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·

Utility·

Universal Search

App Store API

What can you do with the App List API?

The App List endpoint gives you structured App Store data with computed fields in a single request. No scraping infrastructure to build or maintain.

Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/app_store/app-list?app_collection=top_free_ios&app_category=photo_and_video&depth=100"

import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/app_store/app-list",
    params={
    'app_collection': 'top_free_ios',
    'app_category': 'photo_and_video',
    'depth': '100',
    },
    headers={"x-api-key": "YOUR_API_KEY"},
)

data = response.json()

const response = await fetch(
  "https://www.socialcrawl.dev/v1/app_store/app-list?app_collection=top_free_ios&app_category=photo_and_video&depth=100",
  {
    headers: { "x-api-key": "YOUR_API_KEY" },
  },
);

const data = await response.json();

Parameters

Parameter	Required	Description
app_collection	Yes	Chart to retrieve: top_free_ios, top_paid_ios, top_grossing_ios, new_ios, new_free_ios, new_paid_ios. An unknown value is rejected with a free 400 that lists the accepted set.
app_category	No	Optional Apple App Store category to scope the chart (e.g. 'photo_and_video', 'games_puzzle'). (books \| business \| catalogs \| education \| entertainment \| finance \| food_and_drink \| games \| games_action \| games_adventure \| games_arcade \| games_board \| games_card \| games_casino \| games_dice \| games_educational \| games_family \| games_music \| games_puzzle \| games_racing \| games_role_playing \| games_simulation \| games_sports \| games_strategy \| games_trivia \| games_word \| health_and_fitness \| lifestyle \| magazines_and_newspapers \| magazines_arts \| magazines_automotive \| magazines_weddings \| magazines_business \| magazines_children \| magazines_computer \| magazines_food \| magazines_crafts \| magazines_electronics \| magazines_entertainment \| magazines_fashion \| magazines_health \| magazines_history \| magazines_home \| magazines_literary \| magazines_men \| magazines_movies_and_music \| magazines_politics \| magazines_outdoors \| magazines_family \| magazines_pets \| magazines_professional \| magazines_regional \| magazines_science \| magazines_sports \| magazines_teens \| magazines_travel \| magazines_women \| medical \| music \| navigation \| news \| photo_and_video \| productivity \| reference \| shopping \| social_networking \| sports \| travel \| utilities \| weather)
country	No	Storefront country as an ISO code ('US'), a full name, or a numeric code. Defaults to the US.
language	No	Language code (e.g. 'en'). Defaults to 'en'.
depth	No	Number of apps to retrieve (default 100, rounded up to multiples of 100, max 500).

Example Response

What does the App Store App List API return?

Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.

Example response

{
  "success": true,
  "platform": "app_store",
  "endpoint": "/v1/app_store/app-list",
  "data": {
    "items": [
      {
        "app": {
          "id": "1500855883",
          "store": "app_store",
          "url": "https://apps.apple.com/us/app/capcut-photo-video-editor/id1500855883",
          "title": "CapCut: Photo & Video Editor",
          "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/d3/1e/cd/d31ecd04-5ad6-cd62-b095-271798f99365/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/512x512bb.jpg",
          "description": null,
          "developer": {
            "id": null,
            "name": null,
            "url": null,
            "email": null,
            "address": null,
            "website": null
          },
          "rating": {
            "value": 4.6,
            "max": 5,
            "count": 1116052
          },
          "price": {
            "current": 0,
            "original": null,
            "currency": "USD",
            "is_free": true,
            "displayed": null
          },
          "reviews_count": 1116052,
          "category": "photo_and_video",
          "categories": null,
          "installs": null,
          "version": null,
          "minimum_os_version": null,
          "size": null,
          "released_at": null,
          "updated_at": null,
          "update_notes": null,
          "image_urls": null,
          "ext": {
            "appdata": {
              "type": "app_store_search_organic",
              "rank_group": 1,
              "rank_absolute": 1,
              "position": "left",
              "app_id": "1500855883",
              "title": "CapCut: Photo & Video Editor",
              "url": "https://apps.apple.com/us/app/capcut-photo-video-editor/id1500855883",
              "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/d3/1e/cd/d31ecd04-5ad6-cd62-b095-271798f99365/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/512x512bb.jpg",
              "reviews_count": 1116052,
              "rating": {
                "rating_type": "Max5",
                "value": 4.6,
                "votes_count": 1116052,
                "rating_max": 5
              },
              "is_free": true,
              "price": {
                "current": 0,
                "regular": null,
                "max_value": null,
                "currency": "USD",
                "is_price_range": false,
                "displayed_price": null
              },
              "category_drift_probe": true,
              "main_category": "photo_and_video"
            }
          }
        }
      },
      {
        "app": {
          "id": "389801252",
          "store": "app_store",
          "url": "https://apps.apple.com/us/app/instagram/id389801252",
          "title": "Instagram",
          "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/de/ef/4c/deef4c28-359a-c51d-2585-f7f186cf28b1/Prod-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/512x512bb.jpg",
          "description": null,
          "developer": {
            "id": null,
            "name": null,
            "url": null,
            "email": null,
            "address": null,
            "website": null
          },
          "rating": {
            "value": 4.7,
            "max": 5,
            "count": 29309747
          },
          "price": {
            "current": 0,
            "original": null,
            "currency": "USD",
            "is_free": true,
            "displayed": null
          },
          "reviews_count": 29309747,
          "category": "photo_and_video",
          "categories": null,
          "installs": null,
          "version": null,
          "minimum_os_version": null,
          "size": null,
          "released_at": null,
          "updated_at": null,
          "update_notes": null,
          "image_urls": null,
          "ext": {
            "appdata": {
              "type": "app_store_search_organic",
              "rank_group": 2,
              "rank_absolute": 2,
              "position": "left",
              "app_id": "389801252",
              "title": "Instagram",
              "url": "https://apps.apple.com/us/app/instagram/id389801252",
              "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/de/ef/4c/deef4c28-359a-c51d-2585-f7f186cf28b1/Prod-0-0-1x_U007epad-0-1-0-sRGB-85-220.png/512x512bb.jpg",
              "reviews_count": 29309747,
              "rating": {
                "rating_type": "Max5",
                "value": 4.7,
                "votes_count": 29309747,
                "rating_max": 5
              },
              "is_free": true,
              "price": {
                "current": 0,
                "regular": null,
                "max_value": null,
                "currency": "USD",
                "is_price_range": false,
                "displayed_price": null
              },
              "category_drift_probe": true,
              "main_category": "photo_and_video"
            }
          }
        }
      }
    ],
    "total": 100,
    "dropped": 0
  },
  "credits_used": 5,
  "credits_remaining": 9999,
  "request_id": "req_example000000",
  "cached": false,
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "page_size": 100
  }
}

Live sample illustrating the unified response shape. Field values reflect the record you query.

API Details

How does the App Store App List API work?

Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.

Method

GET

Response

JSON

Why SocialCrawl

Why use SocialCrawl for App Store App List data?

We handle the complexity of App Store data extraction so you can focus on building. Unified schema, AI enrichment, and zero platform logic in your code.

One schema for every platform, so you write your integration once
When an endpoint supports a computed field and the required source inputs are available, normalized records can include fields such as engagement rate, reach, category, and language
No scraping infrastructure to build, no proxies to manage, no rate limits to fight
Current public App Store data, with the endpoint's documented cache window and 0-credit hits; send Cache-Control: no-cache for a billed refresh

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 65 platforms covering 10B+ monthly active users.

One schema, every platform

Query 65 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.

See your data before you code

Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()

[ .JSON ]

{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}

+ 65 platforms

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

How do I get Apple App Store top charts with an API?

Send a GET request to /v1/app_store/app-list with an app_collection parameter: top_free_ios, top_paid_ios, top_grossing_ios, or the iPad and new-app variants. The response is a ranked AppList where each app's position is its chart rank.

Which Apple App Store charts can I pull?

You can pull top free, top paid, and top grossing charts for both iPhone and iPad, plus new-app charts. Add an optional app_category parameter to scope a chart to one App Store category, such as photo_and_video or games_puzzle.

How is the charts endpoint different from app search?

The charts endpoint returns store rankings: the apps the Apple App Store currently lists as top free, paid, or grossing, in rank order. App search instead returns keyword matches, and app-listings-search queries a filterable paginated database by title.

How much does the App Store charts endpoint cost?

App-list runs on the advanced tier at 5 credits per call, since it fetches a fresh ranked chart from the Apple App Store. New accounts get 100 free credits with no card, and an empty chart is refunded automatically.

Can I track iOS chart movement over time?

Yes. Because each app comes back with its current rank, calling the charts endpoint on a schedule lets you snapshot iPhone and iPad rankings and detect movers, useful for competitor monitoring and category trend tracking.

Ask AI about SocialCrawl

Ask ChatGPT Ask Perplexity Ask Gemini Ask Claude Ask Grok

More App Store API endpoints

Every App Store endpoint returns the same unified schema.

App Search Search Suggestions App Info App Reviews App Listings Search Categories

API reference App Store API guide

Ready to scrape App Store App List data?

Get your API key and start pulling App Store data in under 60 seconds.

Start for free

🤖 AI agent or LLM? Read this page as markdown