Bulk Create Keywords
Creates multiple keywords in a single request.
URL
POST https://api.ads.apple.com/v1/keywords/bulk-createHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | KeywordCreateBulkResponse | |
| 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 creates multiple keywords in a single request. Each item in the items array contains a correlationId and a data object with the keyword fields. The adGroupId and text fields are required per item. You can optionally set bid to override the ad group’s default bid.
A single request can create keywords across different ad groups. This makes the endpoint well-suited for seeding a new campaign structure with a full keyword list in one call, rather than creating keywords one ad group at a time.