Query Ad Creatives
Retrieve ad creatives that match structured filter, sort, and pagination criteria.
URL
POST https://api.ads.apple.com/v1/creatives/queryHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | CreativeQueryResponse | |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | |
| 401 | Unauthorized Content-Type: application/json | ErrorResponse | |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | |
| 404 | Not Found Content-Type: application/json | ErrorResponse | |
| 429 | Too Many Requests Content-Type: application/json | ErrorResponse | |
| 500 | Internal Server Error Content-Type: application/json | ErrorResponse |
Discussion
This endpoint queries ad creatives using the standard QueryRequest structure. The endpoint supports field filtering, multi-field sorting, and offset-based pagination. The system automatically scopes results to the ad accounts accessible to the authenticated caller. You can’t query by adAccountId. See Creatives Endpoints for the fields you can filter on.
By default, results exclude deleted ad creatives. To include deleted records, add an explicit filter on "field": "deleted", "operator": "EQUALS", "value": true.
See QueryFilterOperator for the full set of supported comparison operators.
Filterable Fields
Field | Type | Operators | Sortable | Description |
|---|---|---|---|---|
| integer |
| Yes (default) | Primary identifier of the ad creative. |
| integer |
| Reference to the ad account. | |
| string |
| Name of the ad creative. | |
| string (enum) |
| Type of ad creative. See Creativetype. | |
| string (enum) |
| System validation status. | |
| boolean |
| Whether the ad creative has been deleted. Excluded by default unless explicitly filtered to |
The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination.