Get Launch Keyword Recommendations
GET/api/advertising/launch/recommendations
Returns keyword recommendations for launching one product on one ad account, plus history hints from similar products (same categories): search terms that converted and terms that drew at least 10 clicks but never converted.
advertising:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Recommendations come from the ad platform where it supports them (Amazon by ASIN, others by listing identifier). keywords is empty when the platform has none or the product is not listed on the account's channel.
Requires the advertising.view permission and the Advertising Manager feature.
Required query parameters: ad_account_id, product_id.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.