Find Campaign Negative Keywords
Fetches negative keywords for campaigns.
URL
POST https://api.searchads.apple.com/api/v5/campaigns/{campaignId}/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 campaign negative keywords. Use the associated campaignId in the URI. Find calls use Selector Condition operators to narrow results. If you don’t specify any selector conditions, all negative keywords in the campaign return in the response. See the NegativeKeyword object for details about selector Condition operators per field.
Payload example: Find campaign negative keywords
HTTP Body
The request body that includes the selector Condition. Selector objects define what data the API returns when fetching resources.