# Search iOS apps

Search the live App Store by name.

## Endpoint: POST /v1/aso/app-search

- Method: `POST`
- Path: `/v1/aso/app-search`
- Authentication: Bearer API credential or OAuth access token
- Required scope: `content:write`
- MCP tool: `manage_aso`
- MCP action: `search_ios`

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `term` | body | string | yes | App Store search text. |

## Known errors

- 400 invalid_request for an invalid filter, identity or limit.
- 401 authentication_required for a missing or invalid credential.
- 402 subscription_required when access is not entitled.
- 403 authorization_required for a missing scope or unavailable preview access.
- 403 workspace_not_accessible when x-genviral-tenancy names a workspace the credential cannot reach.
- 404 not_found when the record is outside the accessible catalogue.
- 429 rate_limited; honor Retry-After when present.
- 429 daily_call_limit; the plan's daily API and MCP calls are used until 00:00 UTC.
- 409 conflict when the write would duplicate an exclusive row.

## Request

This explicit command searches Apple's public App Store by name. Standard API rate limits apply.

```
curl --request POST 'https://api.peekpanda.com/v1/aso/app-search' \
  --header "Authorization: Bearer $PEEKPANDA_TOKEN" \
  --header 'x-genviral-tenancy: personal' \
  --header 'content-type: application/json' \
  --data '{"term":"calorie"}'
```

## MCP request

Call manage_aso with action search_ios. Path fields go in params, filters in query, and a write body in body.

```
{
  "name": "manage_aso",
  "arguments": {
    "request": {
      "action": "search_ios"
    }
  }
}

```

## Response

The response contains public App Store matches for the supplied term.

```
{
  "data": [
    {
      "storeId": "0000000000",
      "name": "Example Calorie Tracker",
      "iconUrl": null,
      "developerName": "Example Labs",
      "primaryGenre": "Health & Fitness",
      "rating": 4.7,
      "ratingCount": 12450,
      "inCatalogue": true
    }
  ],
  "term": "calorie"
}

```

## Source

Dated public App Store search results and suggestion observations for the US English storefront. Positions are observed result order. Difficulty and demand are directional indicators, not search volume or advertising data.

## Refresh

This explicit search command reads the public App Store. Standard API rate limits apply.