Apple Ads Change History & Recommendations

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.

Requires connected Apple Search Ads credentials.

Change History

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.

curl

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:

{
  "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

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

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. 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

App Store Connect

Google Play Console

RevenueCat

Superwall

Apple Search Ads

Meta & TikTok Ads

Change History

Change detail

Budget and Target CPA Recommendations

MCP Tools

​Change History

​Change detail

​Budget and Target CPA Recommendations

​MCP Tools

Change History

Change detail

Budget and Target CPA Recommendations

MCP Tools