---
title: Query Ads
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/post-ads-query
---

# Query Ads

Searches and filters ads using structured query criteria including field filters, sorting, and pagination.

## URL

POST https://api.ads.apple.com/v1/ads/query

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

Discussion This endpoint queries ads using a standard QueryRequest body. Filter by adGroupId to scope results to a specific ad group, or by campaignId to retrieve all ads across an entire campaign. An empty request body returns all ads for the ad account with default pagination. The system excludes deleted ads from results by default. To retrieve deleted ads, include a deleted EQUALS true filter. See QueryFilterOperator for the full set of supported comparison operators. Filterable Fields  |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |   |  |  |  |  The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination. Payload Examples

## See Also

- [Create an Ad](apple-ads-platform-api/post-ads.md)
- [Get an Ad](apple-ads-platform-api/get-ads-_id_.md)
- [Update an Ad](apple-ads-platform-api/put-ads-_id_.md)
- [Delete an Ad](apple-ads-platform-api/delete-ads-_id_.md)