> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apple Ads Change History & Recommendations

> See who changed your Apple Ads campaigns and read Apple's daily budget and target CPA suggestions

Two read-only views from the Apple Ads Platform API: an audit log of changes in your account, and Apple's own budget and target CPA suggestions for your campaigns.

> [!TIP]
>
> Requires connected [Apple Search Ads credentials](https://docs.appeeky.com/docs/apple-search-ads-credentials.md).

***

## Change History

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
GET /v1/connect/apple-ads/change-history
```

| Parameter | Description |
| - | - |
| `from` | Start date, `YYYY-MM-DD`. Default 30 days ago. Apple keeps 6 months. |
| `to` | End date, `YYYY-MM-DD`. Default today. |
| `entityTypes` | Comma-separated: `Campaign`, `AdGroup`, `Keyword`, `NegativeKeyword`, `Ad`. Default all five. |
| `eventTypes` | Comma-separated: `CREATE`, `UPDATE`, `DELETE` |
| `campaignId` | Only changes in this campaign (ad groups, keywords, negative keywords) |
| `adGroupId` | Only changes in this ad group (keywords, negative keywords) |
| `limit`, `offset` | Paging. Default 50 rows. |

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/connect/apple-ads/change-history?entityTypes=Keyword&eventTypes=UPDATE&from=2026-11-01" \
  -H "X-API-Key: YOUR_APPEEKY_KEY"
```

Each row is one transaction for one entity type, newest first:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": [
    {
      "transactionId": "483d0e81-0630-4a13-9403-ea9c5fd16269",
      "eventType": "CREATE",
      "eventTime": "2026-10-04T00:32:20.513",
      "entityType": "NegativeKeyword",
      "userType": "CUSTOMER_API",
      "modifiedBy": "107044319",
      "count": 5,
      "metas": [
        {
          "detailId": "NegativeKeyword.2347562730.483d0e81-0630-4a13-9403-ea9c5fd16269",
          "meta": { "text": "voice recorder", "matchType": "EXACT", "campaignId": "2144321909" }
        }
      ]
    }
  ],
  "pagination": { "offset": 0, "pageSize": 50, "totalCount": 1 }
}
```

`userType` tells you whether a person in the Apple Ads UI (`CUSTOMER`), an API client such as Appeeky (`CUSTOMER_API`), or Apple Support made the change.

### Change detail

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
GET /v1/connect/apple-ads/change-history/:detailId
```

Pass a `detailId` from `metas[]` to get every field that changed, with old and new values.

***

## Budget and Target CPA Recommendations

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
GET /v1/connect/apple-ads/recommendations/daily-budgets?adamId=YOUR_APP_ID
GET /v1/connect/apple-ads/recommendations/target-cpas?adamId=YOUR_APP_ID
```

| Parameter | Description |
| - | - |
| `adamId` | Required. The app's App Store ID. |
| `campaignId` | Only this campaign |
| `state` | `AVAILABLE` (default), `APPLIED`, or `DISMISSED` |
| `limit` | Default 50, max 200 |

Daily budget recommendations show the current budget, the suggested budget, recent installs, spend, and CPA, and the installs and spend Apple expects at the new budget. Target CPA recommendations only exist for campaigns that use the Maximize Conversions bid strategy.

Appeeky only reads recommendations. Apply them in the Apple Ads UI, or change the budget with [`PUT /campaigns/:campaignId`](https://docs.appeeky.com/docs/apple-search-ads-campaigns).

An empty `data` array means Apple has no suggestion for the app right now.

***

## MCP Tools

| Tool | Description |
| - | - |
| `asa_change_history` | Who changed what in the account |
| `asa_change_history_detail` | Old and new values for one change |
| `asa_campaign_recommendations` | Daily budget or target CPA suggestions |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.