Get iPhone apps from App Store charts

Choose an App Store chart collection and category, plus supported location and language codes. After the lookup completes successfully, get up to 20 available iOS app entries with recorded chart positions and listing details.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use apple-app-list to retrieve one selected Apple App Store chart. Accept chart type, app category, country or region, and language in everyday names; map them to supported app_collection, app_category, location_code and language_code values. Interpret phrases such as free apps, paid apps, top-earning apps, new apps, new free apps and new paid apps only when they clearly select the documented chart. Map clear everyday category names to supported categories. If any choice is ambiguous or unsupported, ask the user to choose by ordinary name, never a code. Do not guess or use defaults. Always set the required fixed request.depth=20; do not ask about it or promise twenty returned rows. Preserve the selected chart, category, country and language with the result. After successful completion, summarize available app titles, chart positions, App Store links, ratings with their scales, review counts and displayed prices with currency. Distinguish the two position meanings and the source total from returned entries. Preserve missing values. Explain that chart positions are not recommendations or revenue, displayed prices do not include all in-app costs, and receipt time does not guarantee current listing values.

Task:
Show [free iPhone apps] on the [Games category] list for [United States] in [English]. List available apps with store links, their place in the list, ratings, and prices with currency (such as US dollars). Note missing details and name the list used.

Paste into your connected AI's conversation.

Connection guide

Up to 0.15 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

DataForSEO

Get iPhone apps from App Store charts

You receive

Receive the available apps from your selected App Store chart, category and locale after the chart lookup completes successfully. Entries can include app IDs and titles, recorded chart positions, App Store page links and icon references, plus available ratings with their scales, review counts and displayed prices with their currencies. Your Agent can turn the returned entries into a chart summary. Keep the chart collection, category, market and language alongside the list so its positions and listing details retain their context.

Start with your task

Show [free iPhone apps] on the [Games category] list for [United States] in [English]. List available apps with store links, their place in the list, ratings, and prices with currency (such as US dollars). Note missing details and name the list used.

What to know

The fixed depth of 20 caps the request; it does not guarantee twenty entries or a complete chart. Positions describe the selected chart and locale, not editorial recommendations, global rankings, installs or revenue. Completion time and freshness are not guaranteed, and a result receipt time does not establish when every position or price was updated. Missing details remain unknown.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Chart lookup request`request`	`object`	Required	Required App Store chart lookup containing chart collection, category, supported language code, supported location code and depth 20. Provide all five values; example values are not automatically filled in. Required fields `app_collection, location_code, language_code, depth, app_category`
Chart entry limit`request.depth`	`integer`	Required	Required integer with the exact value 20. It sets the requested parsing depth and caps the list request; it is not a guarantee of twenty returned apps or complete chart coverage. Fixed value `20`
App category`request.app_category`	`string`	Required	Required supported App Store category code, supplied as a string of 1–256 characters. Examples include games and lifestyle. Select a category rather than an app name, app ID or arbitrary description; omitting the category is not supported here. Minimum length `1` Maximum length `256`
Language code`request.language_code`	`string`	Required	Required supported App Data Apple language code, supplied as a string of 1–256 characters. For example, en means English. Use a code rather than a language name; en is an example, not a fixed language or default. Minimum length `1` Maximum length `256`
Location code`request.location_code`	`integer`	Required	Required supported App Data Apple market code, supplied as an integer from 1 to 100,000,000. For example, 2840 selects the United States. The example is not a default or fixed market, and the numeric range alone does not establish support. Minimum `1` Maximum `100000000`
Chart collection`request.app_collection`	`string`	Required	Required supported iOS chart collection, supplied as a string of 1–256 characters. Documented values are top_free_ios, top_paid_ios, top_grossing_ios, new_ios, new_free_ios and new_paid_ios. They select different top/free/paid/grossing or new-app lists; choose the intended collection explicitly. Minimum length `1` Maximum length `256`

View raw JSON

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "app_collection",
        "location_code",
        "language_code",
        "depth",
        "app_category"
      ],
      "properties": {
        "depth": {
          "type": "integer",
          "const": 20
        },
        "app_category": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "language_code": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "location_code": {
          "type": "integer",
          "maximum": 100000000,
          "minimum": 1
        },
        "app_collection": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

Choose the chart collection that matches your question: top-free, top-paid, top-grossing or one of the new-app collections. Also provide a supported category code, such as games or lifestyle; category is required here. A top-grossing chart selection returns chart records, not each app’s revenue. Language and location must use supported App Data codes; en and 2840 are examples, not defaults or the only supported locale.

Get iPhone apps from App Store charts

Get iPhone apps from App Store charts

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Choose the type of chart

Choose a category and country

Understand the chart

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Choose the type of chart

Choose a category and country

Understand the chart

Questions about this tool.

How do I choose the chart and category?

Will the result contain exactly twenty apps?

What do the position numbers mean?

Do a free flag, price or rating prove value or total cost?

When does the chart arrive, and is it live?