Bulk Update Keywords
Updates multiple keywords in a single request.
URL
POST https://api.ads.apple.com/v1/keywords/bulk-updateHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | KeywordUpdateBulkResponse | |
| 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 updates multiple keywords in a single request. Each item in the items array must include the keyword id. You can update only bid and status per keyword. The keyword text and matchType are immutable after creation.
This endpoint is well-suited for batch bid adjustments. For example, raise bids on high-performing keywords after a performance review, or pause a set of underperforming keywords in one call.