<!--
{
  "availability" : [
    "Search Ads: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/apple_ads/Selector",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads"
    ],
    "preciseIdentifier" : "data:apple_ads:Selector"
  },
  "title" : "Selector"
}
-->

# Selector

The selector objects available to filter returned data.

```
object Selector
```

## Discussion

[`Selector`](/documentation/apple_ads/Selector) objects define what data the API returns when fetching resources. You use [`Selector`](/documentation/apple_ads/Selector) objects with find calls and reporting endpoints.

|**Functionality**|**Description**                                            |
|-----------------|-----------------------------------------------------------|
|Filtering        |Specifies the criteria to filter the resources that return.|
|Sorting          |Specifies the criteria to order the resources that return. |
|Paginating       |Specifies the page segment of resources that return.       |

The following is an example of using selectors to filter returned records:

```console
POST https://api.searchads.apple.com/api/v5/campaigns/find

{  
  "fields": [
    "id",
    "name",
    "adamId",
    "dailyBudgetAmount",
    "status",
    "servingStatus"
  ],
  "conditions": [
    {
      "field": "servingStatus",
      "operator": "IN",
      "values": [
        "NOT_RUNNING"
      ]
    }
  ],
  "orderBy": [
    {
      "field": "id",
      "sortOrder": "DESCENDING"
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 10
  }
}
```

You can also use [`Selector`](/documentation/apple_ads/Selector) objects to find archived or soft-deleted campaigns. By default, API fetch calls don’t return deleted resources, with the exception of GET by `a` resource `Id`. To retrieve deleted resources, you must explicitly request the call using the selector [`Condition`](/documentation/apple_ads/Condition).

The following example returns both deleted and undeleted resources:

```json
{
  "fields": null,
  "conditions": [
    {
      "field": "deleted",
      "operator": "IN",
      "values": [
        true,
        false
      ]
    }
  ],
  "orderBy": [
    {
      "field": "name",
      "sortOrder": "ASCENDING"
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 100
  }
}
```

---

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)