# Apple API: Search apps

> Finds iPhone and iPad apps by keyword in a chosen country's App Store, with ratings, prices, categories and App Store links.

Unofficial. Not affiliated with or endorsed by Apple.

- Page: https://fous.com/methods/apps.apple.com/search-apps
- Method: `apps.apple.com/search_apps`, version 1
- Website: apps.apple.com
- Returns: app name, developer, rating, rating count, price, currency, category, App Store link, app ID
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `query` | string | yes | `"budget tracker"` | Keywords to search for, such as budget tracker. |
| `country` | string | no |  | Country name or two-letter country code, such as United States or GB. Default "United States". |
| `max_results` | integer | no |  | Maximum number of apps to return, such as 20. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "query": "budget tracker"
}
```

Its output:

```json
{
  "apps": [
    {
      "price": 0,
      "app_id": 1525179720,
      "app_name": "Budget app - spending tracker",
      "category": "Finance",
      "currency": "USD",
      "developer": "InnerGrow",
      "rating_count": 16219,
      "app_store_link": "https://apps.apple.com/us/app/budget-app-spending-tracker/id1525179720?uo=4",
      "average_rating": 4.71983
    },
    {
      "price": 0,
      "app_id": 1621020173,
      "app_name": "Fleur - Budget Planner App",
      "category": "Finance",
      "currency": "USD",
      "developer": "Akash Jain",
      "rating_count": 13087,
      "app_store_link": "https://apps.apple.com/us/app/fleur-budget-planner-app/id1621020173?uo=4",
      "average_rating": 4.80124
    },
    {
      "price": 0,
      "app_id": 548615579,
      "app_name": "Spending Tracker",
      "category": "Finance",
      "currency": "USD",
      "developer": "MH Riley Ltd",
      "rating_count": 19484,
      "app_store_link": "https://apps.apple.com/us/app/spending-tracker/id548615579?uo=4",
      "average_rating": 4.78043
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"apps.apple.com/search_apps","input":{"query":"budget tracker"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find the top 10 meditation apps on the App Store in the UK with their ratings and prices
- I need a list of budget tracker apps available in Germany, showing developer names and App Store links, max 15 results
- What fitness apps can I find on apple.com for the US store? Include rating counts and categories
- Show me free note-taking apps for iPad in Canada, with app IDs
- Look up language learning apps in Japan on the App Store and tell me their prices and currencies, up to 50 results

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Keywords to search for, such as budget tracker."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter country code, such as United States or GB."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of apps to return, such as 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "apps"
  ],
  "properties": {
    "apps": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "app_name",
          "developer",
          "average_rating",
          "rating_count",
          "price",
          "currency",
          "category",
          "app_store_link",
          "app_id"
        ],
        "properties": {
          "price": {
            "type": [
              "number",
              "null"
            ],
            "description": "App price, 0 when free."
          },
          "app_id": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Apple App Store ID."
          },
          "app_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "App name."
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "description": "App category."
          },
          "currency": {
            "type": [
              "string",
              "null"
            ],
            "description": "Currency code for the price."
          },
          "developer": {
            "type": [
              "string",
              "null"
            ],
            "description": "Developer name."
          },
          "rating_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of user ratings."
          },
          "app_store_link": {
            "type": [
              "string",
              "null"
            ],
            "description": "Link to the app's App Store page."
          },
          "average_rating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Average user rating out of 5."
          }
        }
      },
      "description": "Apps in App Store search order."
    }
  }
}
```

## See more

- [Apple API: Search podcasts](https://fous.com/methods/podcasts.apple.com/search-podcasts.md): Finds Apple Podcasts shows by name or topic in a country, ordered by search relevance, with ratings when the show page provides them.
- [Apple API: Get app reviews](https://fous.com/methods/apps.apple.com/get-app-reviews.md): Gets customer reviews for an iPhone or iPad app, found by name or App Store link, from the selected country's App Store.
- [Apple API: Search songs](https://fous.com/methods/music.apple.com/search-songs.md): Searches the Apple Music song catalog by title and artist words, returning matching tracks in relevance order with prices and previews when available.
- [Apple API: Get App Store app](https://fous.com/methods/apps.apple.com/get-app.md): Gets an iPhone or iPad app's public App Store listing by name or link. You can narrow it by developer and country. In-app purchases are included when the page lists them.
- [Apple API: List top App Store charts](https://fous.com/methods/apps.apple.com/list-top-charts.md): Lists ranked iPhone or iPad apps from the public App Store charts for a chart, category, and country. App bundles and apps that are no longer available are left out.
- [Apple API: List top charts](https://fous.com/methods/music.apple.com/list-top-charts.md): Lists the current top songs, albums, or music videos on Apple Music for a country, in chart order. Countries without an Apple Music chart return no results.
- [Apple API: Get podcast reviews](https://fous.com/methods/podcasts.apple.com/get-podcast-reviews.md): Gets a podcast's country-specific rating total and average, plus up to 500 listener reviews sorted by newest or most helpful.
- [Apple API: List refurbished products](https://fous.com/methods/apple.com/list-refurbished-products.md): Lists the Apple Certified Refurbished products shown for a product type and country, cheapest first. Original prices and savings are included only when Apple shows them.
- [All Apple methods](https://fous.com/methods/apple.com.md)
