Find Ad Group Negative Keywords
Fetches negative keywords in a campaign’s ad groups.
URL
POST https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/adgroups/negativekeywords/findPath Parameters
| Name | Type | Description |
|---|---|---|
campaignId Required | int64 | The unique identifier for the campaign. |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | NegativeKeywordListResponse | If the call succeeds, the API returns a list of NegativeKeyword objects in the response payload with an HTTP status code of |
| 400 | Bad Request Content-Type: application/json | ApiErrorResponse | An invalid query or missing required parameters. |
| 401 | Unauthorized Content-Type: application/json | ApiErrorResponse | An unauthenticated call fails to get the requested response. |
| 403 | Forbidden Content-Type: application/json | ApiErrorResponse | Insufficient rights to the resource. |
| 404 | Not Found Content-Type: application/json | ApiErrorResponse | The API can’t locate the resource. |
| 429 | Content-Type: application/json | ApiErrorResponse | The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API. |
| 500 | Internal Server Error Content-Type: application/json | ApiErrorResponse | The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later. |
Discussion
Use this endpoint to find negative keywords in different ad groups within the same campaign. Use the associated campaignId in the URI. Find calls use Selector Condition operators to narrow results. If you don’t specify any selector conditions, the API returns all negative keywords across all ad groups of the campaign. See the NegativeKeyword object for details about Selector condition operators per field.
Payload example: Find ad group negative neywords
HTTP Body
Selector objects define what data the API returns when fetching resources.