App Store Top Paid iPhone Apps Chart (US, English)

omnial/app-store-top-paid-iphone-apps-us-english

Returns the US App Store's top paid iPhone apps chart, in English: up to 100 apps in chart order, each with its chart position, Apple app ID, name, current store price and its currency, average star rating and rating count, plus when the chart was retrieved.

activeper callv1

Price

Up to $0.00328 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Apple App Store

Data from the Apple App Store.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/app-store-top-paid-iphone-apps-us-english" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/app-store-top-paid-iphone-apps-us-english" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/app-store-top-paid-iphone-apps-us-english", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/app-store-top-paid-iphone-apps-us-english", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.00328

Updated: Oct 17, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "app_collection",
    "location_code",
    "language_code"
  ],
  "properties": {
    "depth": {
      "enum": [
        10,
        100
      ],
      "type": "integer",
      "default": 100,
      "description": "The number of chart entries to collect, 10 or 100 (default 100); the store returned its first 100 entries for either value."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "description": "The chart language; only en (English) is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "description": "The store read; only 2840 (United States) is offered."
    },
    "app_collection": {
      "enum": [
        "top_paid_ios"
      ],
      "type": "string",
      "description": "The chart to read; only top_paid_ios (top paid iPhone apps) is offered."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "price": {
                  "type": "object",
                  "properties": {
                    "current": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "The app's current store price, in the given currency."
                    },
                    "currency": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The currency code of the store price."
                    }
                  }
                },
                "title": {
                  "type": "string",
                  "description": "The app's name."
                },
                "app_id": {
                  "type": "string",
                  "description": "The app's numeric Apple ID."
                },
                "rating": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Average star rating, 0 to 5; null when the store shows none."
                    },
                    "votes_count": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Number of ratings; null when the store shows none."
                    }
                  }
                },
                "rank_absolute": {
                  "type": "number",
                  "description": "The app's chart position, from 1."
                }
              }
            },
            "description": "The apps, in chart order."
          },
          "datetime": {
            "type": "string",
            "description": "When the chart was retrieved (UTC)."
          },
          "items_count": {
            "type": "number",
            "description": "The number of entries in items."
          },
          "se_results_count": {
            "type": "number",
            "description": "The number of chart entries the store reported."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}