<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/Query-target-CPA-suggestion",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "rest:apple-ads-platform-api:post:suggestions-target-cpas-query"
  },
  "title" : "Query Target CPA Suggestion"
}
-->

# Query Target CPA Suggestion

Retrieve the recommended target CPA for a new Maximize Conversions campaign on the App Store.

## Discussion

This endpoint returns the suggested target CPA for a [campaign](/documentation/Apple-Ads-Platform-API/campaigns-endpoints). The suggestion is the maximum tap-install CPI observed across the specified app’s eligible markets over the last 28 days. Only countries or regions with at least 10 installs in that window qualify.

To identify the app, use `promotedObjectId` and `promotedObjectType`. Scope results to specific markets with an optional `countryOrRegion` filter. The response returns the single highest suggested target CPA and the market that produced it, along with the `appCategory` the suggestion applies to.

See [`FilterOperator`](/documentation/Apple-Ads-Platform-API/RecommendationFilterOperator) for the full set of supported comparison operators.

### Filterable Fields

|Field               |Type            |Operators|Description                                                                                                                       |
|--------------------|----------------|---------|----------------------------------------------------------------------------------------------------------------------------------|
|`promotedObjectId`  |string          |`EQUALS` |Required. A single numeric App Store app ID.                                                                                      |
|`promotedObjectType`|string (enum)   |`EQUALS` |Required. Must be `APPSTORE_APP`.                                                                                                 |
|`countryOrRegion`   |array of strings|`IN`     |Optional. One or more ISO 3166-1 alpha-2 country or region codes. When omitted, all eligible countries and regions are considered.|

## Payload Examples

**All Eligible Countries:**

Retrieve the suggested target CPA across all markets. Omitting `countryOrRegion` causes the endpoint to evaluate every country and region with at least 10 installs in the last 28 days and return the highest result.

### Request

Identifies the app by `promotedObjectId` and `promotedObjectType`. Since you don’t supply a country filter, the endpoint evaluates all eligible markets.

```json
POST /v1/suggestions/target-cpas/query

{
 "filters": [
   {
     "field": "promotedObjectId",
     "operator": "EQUALS",
     "value": [
       "987654321"
     ]
   },
   {
     "field": "promotedObjectType",
     "operator": "EQUALS",
     "value": [
       "APPSTORE_APP"
     ]
   }
 ]
}
```

### Response

```json
{
 "result": {
   "promotedObjectId": "987654321",
   "suggestedTargetCPA": {
     "amount": "1.20",
     "currency": "USD"
   },
   "countryOrRegion": [
     "US"
   ],
   "appCategory": "Games"
 }
}
```

**Scoped to Specific Countries:**

Restrict evaluation to specific markets by adding a `countryOrRegion` filter. The endpoint returns the highest suggested target CPA found within those countries or regions only.

### Request

Adds a `countryOrRegion` filter restricting evaluation to the US, GB, and CA markets.

```json
POST /v1/suggestions/target-cpas/query

{
 "filters": [
   {
     "field": "promotedObjectId",
     "operator": "EQUALS",
     "value": [
       "987654321"
     ]
   },
   {
     "field": "promotedObjectType",
     "operator": "EQUALS",
     "value": [
       "APPSTORE_APP"
     ]
   },
   {
     "field": "countryOrRegion",
     "operator": "IN",
     "value": [
       "US",
       "GB",
       "CA"
     ]
   }
 ]
}
```

### Response

```json
{
 "result": {
   "promotedObjectId": "987654321",
   "suggestedTargetCPA": {
     "amount": "0.95",
     "currency": "USD"
   },
   "countryOrRegion": [
     "GB"
   ],
   "appCategory": "Games"
 }
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)