<!--
{
  "availability" : [
    "Search Ads: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple_Ads",
  "identifier" : "/documentation/apple_ads/Find-Campaigns",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads"
    ],
    "preciseIdentifier" : "rest:apple_ads:post:v5-campaigns-find"
  },
  "title" : "Find Campaigns"
}
-->

# Find Campaigns

Fetches campaigns with selector operators.

## Discussion

Use this endpoint to find campaigns using a [`Selector`](/documentation/apple_ads/Selector) [`Condition`](/documentation/apple_ads/Condition) to narrow results. If you don’t specify selector conditions, all campaign objects return in the response. See the [`Campaign`](/documentation/apple_ads/Campaign) object for parameter descriptions and selector condition operators.

### Payload example: Find campaigns

**Request:**

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

{
    "pagination": { 
        "offset": 0,
        "limit": 1000
    },
    "orderBy": [
        {
            "field": "id",
            "sortOrder": "ASCENDING"
        }
    ],
    "conditions": [
        {
            "field": "countriesOrRegions",
            "operator": "CONTAINS_ALL",
            "values": [
                "US","CA"
            ]
        }
    ]
}
```

**Response:**

```json
{
  "data": [
    {
      "id": 542370642,
      "orgId": 40669820,
      "name": "TripTrek example campaign",
      "dailyBudgetAmount": {
        "amount": "500",
        "currency": "USD"
      },
      "adamId": 427916203,
      "paymentModel": "PAYG",
      "locInvoiceDetails": null,
      "budgetOrders": [],
      "displayStatus": "ON_HOLD",
      "adChannelType": "SEARCH",
      "supplySources": [
        "APPSTORE_SEARCH_RESULTS"
      ],
      "biddingStrategy": "MAX_CONVERSIONS",
      "targetCpa": {
        "amount": "10.00",
        "currency": "USD"
      },
      "billingEvent": "TAPS",
      "startTime": "2025-04-08T10:33:31.650",
      "endTime": "2025-04-09T10:33:31.650",
      "status": "ENABLED",
      "servingStatus": "AD_GROUP_MISSING",
      "servingStateReasons": [
        "CAMPAIGN_START_DATE_IN_FUTURE"
      ],
      "modificationTime": "2025-04-08T23:58:05.316",
      "deleted": false,
      "sapinLawResponse": "NOT_ANSWERED",
      "countriesOrRegions": [
        "CA",
        "JP",
        "NZ",
        "US"
      ],
      "countryOrRegionServingStateReasons": {}
    }
  ],
  "pagination": {
    "totalResults": 1,
    "startIndex": 1,
    "itemsPerPage": 10
  }
}
```

### Payload example: Find campaigns by bidding strategy and target CPA

**Request:**

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

{
  "conditions": [
    {
      "field": "biddingStrategy",
      "operator": "EQUALS",
      "values": [
        "MAX_CONVERSIONS"
      ]
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 100
  }
}
```

**Response:**

```json
{
  "data": [
    {
      "id": 542370642,
      "orgId": 40669820,
      "name": "TripTrek example campaign",
      "dailyBudgetAmount": {
        "amount": "500",
        "currency": "USD"
      },
      "adamId": 427916203,
      "paymentModel": "PAYG",
      "locInvoiceDetails": null,
      "budgetOrders": [],
      "displayStatus": "ON_HOLD",
      "adChannelType": "SEARCH",
      "supplySources": [
        "APPSTORE_SEARCH_RESULTS"
      ],
      "billingEvent": "TAPS",
      "biddingStrategy": "MAX_CONVERSIONS",
      "targetCpa": {
        "amount": "12",
        "currency": "MXN"
      },
      "startTime": "2025-04-08T10:33:31.650",
      "endTime": "2025-04-09T10:33:31.650",
      "status": "ENABLED",
      "servingStatus": "AD_GROUP_MISSING",
      "servingStateReasons": [
        "CAMPAIGN_START_DATE_IN_FUTURE"
      ],
      "modificationTime": "2024-04-08T23:58:05.316",
      "deleted": false,
      "sapinLawResponse": "NOT_ANSWERED",
      "countriesOrRegions": [
        "CA",
        "JP",
        "NZ",
        "US"
      ],
      "countryOrRegionServingStateReasons": {}
    }
  ],
  "pagination": {
    "totalResults": 1,
    "startIndex": 1,
    "itemsPerPage": 10
  }
}
```

---

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)