> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_app_store

# search_app_store

> Apple App Store search results for a query in a country: name, developer, rating, rating count, price, category, version. ₹0.12 per call; no apps is ₹0.

## What it does

The iPhone and iPad apps the App Store returns for `query` in a `country`, in `data.rows[]`: `name`, `developer` and `developer_website`, `category`, `rating` and `rating_count`, `price` and `currency`, `description`, `version` and release dates, `size_bytes`, `languages` and the store `url`, with `app_id` and `bundle_id`; `limit` up to 50 (default 10). Use it to see who competes for a search term on the App Store and how they are rated; Google Play is not covered.

India: `country: "in"` for the Indian store.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | no | 1 to 50; default 10; max 50 |
| `query` | string | yes | e.g. "photo editor" |
| `country` | string | no | the two-letter store (us, gb, de, …); default us. e.g. "us" |

## What drives the cost

Nothing: flat per call whatever `limit` says. No apps is `class: "ok_free"`, ₹0. Usually one to two seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.12** per call (`cost_paise: 12`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_app_store"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_app_store"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_app_store","input":{"limit":10,"query":"food delivery","country":"in"}}'
```

## What comes back

`data.rows[]` and `data.meta`. A real answer recorded during the live check of 2026-10-28, trimmed to two apps:

```json
{
  "meta": {
    "blocked": [],
    "elapsed_ms": 619,
    "from_cache": false,
    "llm_calls": 0,
    "pages_fetched": 1,
    "partial": false,
    "warnings": [
      "module: app-store-search: 'food delivery' · in · 9 apps"
    ]
  },
  "recipe": "app-store-search",
  "rows": [
    {
      "app_id": "6748918399",
      "bundle_id": "bundl.toing",
      "categories": [
        "Food & Drink",
        "Lifestyle"
      ],
      "category": "Food & Drink",
      "content_advisories": [],
      "content_rating": "4+",
      "currency": "INR",
      "description": "Introducing toing - Lowest Price Guaranteed. Just food at prices that don’t ghost your wallet. Whether it’s biryani at midnight, burgers between classes, or meals under ₹99 – we’ve got your cravings covered.\n\n\nWhy Choose toing?\n- Tasty delights starting at Rs 49, 69, 99—most dishes under Rs 250! Whether you love biryanis, bowls, or Indian staples, you’ll fin…",
      "developer": "BUNDL TECHNOLOGIES PRIVATE LIMITED",
      "developer_id": "989540919",
      "developer_url": "https://apps.apple.com/in/developer/bundl-technologies-private-limited/id989540919",
      "developer_website": "https://www.toingit.com/",
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/99/a8/bb/99a8bbc9-9323-e0ab-08d5-98c885a15916/toingAppIcon-0-0-1x_U007ephone-0-1-0-85-220.png/512x512bb.jpg",
      "languages": [
        "EN"
      ],
      "minimum_os": "17.0",
      "name": "toing - Food Delivery",
      "price": 0,
      "rating": 4.43,
      "rating_count": 88842,
      "release_notes": "Meet Toing - Your Friendly Neighbourhood food delivery app where prices don’t just claim to be lowest… they’re guaranteed. Like, if the menu at your favorite restaurant says ₹120 for Paneer Butter Masala, Toing will also say ₹120. No surge. No ghost fees. Just straight-up price matching powers.\nAnd speaking of menus - remember those? From Shiv Sagar’s lamina…",
      "released_at": "2025-09-10T07:00:00Z",
      "screenshots_ipad": [],
      "screenshots_iphone": [
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/b9/eb/20/b9eb2019-27e0-80c9-9942-904fe2006619/iOS_1.png/320x480bb.jpg",
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/4b/17/7f/4b177f83-c170-23d2-a604-603b2b5aa548/iOS_2.png/320x480bb.jpg",
        "… 5 more item(s) truncated"
      ],
      "size_bytes": 235009024,
      "url": "https://apps.apple.com/in/app/toing-food-delivery/id6748918399",
      "version": "7.4.0",
      "version_released_at": "2026-10-06T06:38:17Z"
    },
    {
      "app_id": "808796222",
      "bundle_id": "com.Faasos",
      "categories": [
        "Food & Drink",
        "Lifestyle"
      ],
      "category": "Food & Drink",
      "content_advisories": [],
      "content_rating": "4+",
      "currency": "INR",
      "description": "Welcome to EatSure – The Food Court App\nEatSure is your ultimate solution for ordering food online! Discover a wide range of delicious dishes from your favorite restaurants and get them delivered right to your doorstep. Satisfy your cravings with just a few taps!\n\nFeatures:\nExtensive Restaurant Selection\nBrowse through a wide range of restaurants offering mu…",
      "developer": "Rebel Marketplace India Private Limited",
      "developer_id": "1528035260",
      "developer_url": "https://apps.apple.com/in/developer/rebel-marketplace-india-private-limited/id1528035260",
      "developer_website": "https://eatsure.com/",
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/ea/9e/1e/ea9e1e75-d890-a3a9-132e-5401df4e8692/AppIcon-0-0-1x_U007emarketing-0-11-0-85-220.png/512x512bb.jpg",
      "languages": [
        "EN"
      ],
      "minimum_os": "15.0",
      "name": "EatSure Food Delivery",
      "price": 0,
      "rating": 4.53,
      "rating_count": 47950,
      "release_notes": "Bug Fixes & Improvements\n- Fixed reported issues to improve overall app stability and reliability.\n- Improved performance and user experience across key app flows.",
      "released_at": "2014-02-15T00:11:09Z",
      "screenshots_ipad": [
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/ab/e7/5f/abe75f29-8dc0-6221-090a-712e4094a442/IPAD__U00281_U0029.png/576x768bb.png",
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/57/b4/9b/57b49bfc-18a1-49ec-168b-c42e5ae068f7/5318d561-622e-4617-b3ad-afab44804fd5_2048x2732_4.jpg/576x768bb.jpg",
        "… 4 more item(s) truncated"
      ],
      "screenshots_iphone": [
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/77/3b/73/773b7335-cfb2-db8c-c24b-f18be383e5b1/tes4.png/392x696bb.png",
        "https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/44/b2/d6/44b2d64e-0a57-8529-757c-f98052352975/e0820e50-58e2-4785-897a-52c3b4f33fb9_1242x2208_4.jpg/392x696bb.jpg",
        "… 3 more item(s) truncated"
      ],
      "size_bytes": 167364608,
      "url": "https://apps.apple.com/in/app/eatsure-food-delivery/id808796222",
      "version": "7.9.6",
      "version_released_at": "2026-10-07T06:19:31Z"
    },
    "… 7 more item(s) truncated"
  ],
  "version": 1
}
```

## Notes

- About ten apps by default; limit up to 50. No apps is free.
- India: country "in". Usually one to two seconds.
- The App Store only; Google Play is a separate source not offered yet.

## Siblings

- [`search_companies`](https://parel.si/docs/tools/search_companies.md) for the makers as companies.
- [`get_instagram_profile`](https://parel.si/docs/tools/get_instagram_profile.md) for an app's brand account.
