Get a Negative Keyword
Retrieve a single negative keyword by its unique identifier.
URL
GET https://api.ads.apple.com/v1/negative-keywords/{id}Path Parameters
| Name | Type | Description |
|---|---|---|
id Required | string |
Header Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | NegativeKeywordResponse | |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | |
| 401 | Unauthorized Content-Type: application/json | ErrorResponse | |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | |
| 404 | Not Found Content-Type: application/json | ErrorResponse | |
| 429 | Too Many Requests Content-Type: application/json | ErrorResponse | |
| 500 | Internal Server Error Content-Type: application/json | ErrorResponse |
Discussion
This endpoint retrieves a single negative keyword by its ID. The response indicates whether the record is a campaign-level or ad-group-level exclusion based on the presence of the adGroupId field. Campaign-level negatives don’t include adGroupId in the response. Ad-group-level negatives include it.
The presence of adGroupId in the response distinguishes which level the negative keyword applies to.
Condition | Level |
|---|---|
| Campaign-level negative keyword: applies to all ad groups in the campaign |
| Ad-group-level negative keyword: scoped to a single ad group |
Deleted negative keywords remain retrievable by ID and never expose a bid field.
Constraint | Detail |
|---|---|
Deleted negative keywords are returned | A deleted negative keyword is returned with |
Use query endpoint for listing |
|
No | Negative keywords never have a bid field in the response. |