- Auth
- Accounts
- First call
- Reporting
- DSP report
- Sponsored ads V3
- Sponsored ads V2
- Snapshots
- Test accounts
- Amazon Marketing Stream
- Amazon Marketing Cloud
- Administration
- Accounts
- Instances
- Create an instance
- List all instances
- List information about the requested instance
- Update instance details
- Update AWS account metadata in the requested instance
- List advertisers in instance
- Create advertiser update
- Get advertiser update
- Gets advertiser information about the requested AMC instance
- Delete AMC instance
- Reporting
- AMC Audiences
- Rule-based audiences
- Creates query based audience execution metadata information
- Get all query based audiences execution metadata.
- Get query based audience execution metadata for a given audienceExecutionId.
- Update query based audience execution metadata for a given audienceExecutionId.
- Delete query based audience execution metadata for a given audienceExecutionId.
- Lookalike audiences
- Rule-based audiences
- Administration
- Sponsored Products
- Campaigns
- Ad groups
- Product ads
- Product targeting
- Keywords
- Theme-based bid recommendations
- Negative keywords
- Campaign negative keywords
- Negative targets
- Campaign negative targets
- Budget recommendations and missed opportunities
- Budget rules
- Sponsored Brands
- Campaigns
- Ad groups
- Ads
- Targeting
- Recommendations
- Theme targeting
- Create keywords
- Update keyword
- Get keyword
- Delete keyword
- Create negative keywords
- Update negative keyword
- Get negative keyword
- Delete negative keyword
- Create product targets
- Update a product target
- Get product target
- Delete product target
- Create negative product target
- Update negative product target
- Get negative product target
- Delete negative product target
- Get all categories
- Get category refinements
- Ad creatives
- Get brands
- Get landing page ASINS
- Sponsored Display
- Stores
- Product metadata
- Budget rules
- Budget usage
- Creative asset library
- Locations
- Exports
- Sponsored TV
- Amazon DSP
- Partner opportunities
Keyword Recommendation for existing adGroup
POST
/sp/targets/keywords/recommendations
最后修改时间：2025-03-16 02:19:30
责任人：未设置
请求参数
Header 参数
Authorization
string
必需
示例值:
Bearer {{access_token}}
Amazon-Advertising-API-Scope
string
必需
示例值:
{{profileId}}
Amazon-Advertising-API-ClientId
string
必需
示例值:
{{client_id}}
Content-Type
string
必需
示例值:
application/vnd.spkeywordsrecommendation.v5+json
Body 参数application/json
recommendationType
string
必需
sortDimension
string
必需
maxRecommendations
string
必需
locale
string
必需
示例
{
"recommendationType": "KEYWORDS_FOR_ASINS",
"sortDimension": "CLICKS",
"maxRecommendations": "2",
"locale": "es_MX"
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://www.amazon.com/ap/oa/sp/targets/keywords/recommendations' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Amazon-Advertising-API-Scope: {{profileId}}' \
--header 'Amazon-Advertising-API-ClientId: {{client_id}}' \
--header 'Content-Type: application/vnd.spkeywordsrecommendation.v5+json' \
--data-raw '{
"recommendationType": "KEYWORDS_FOR_ASINS",
"sortDimension": "CLICKS",
"maxRecommendations": "2",
"locale" : "es_MX"
}'返回响应
🟢200Success for ad group
application/json
Body
keywordTargetList
array [object {7}]
必需
keyword
string
必需
bidInfo
array [object {5}]
必需
translation
string
必需
userSelectedKeyword
boolean
必需
searchTermImpressionRank
null
必需
searchTermImpressionShare
null
必需
recId
string
必需
impactMetrics
null
必需
示例
{
"keywordTargetList": [
{
"keyword": "foaming hand soap refill",
"bidInfo": [
{
"matchType": "PHRASE",
"theme": "CONVERSION_OPPORTUNITIES",
"rank": 1,
"bid": 311,
"suggestedBid": {
"rangeStart": 126,
"rangeMedian": 311,
"rangeEnd": 476
}
},
{
"matchType": "EXACT",
"theme": "CONVERSION_OPPORTUNITIES",
"rank": 1,
"bid": 256,
"suggestedBid": {
"rangeStart": 125,
"rangeMedian": 256,
"rangeEnd": 455
}
},
{
"matchType": "BROAD",
"theme": "CONVERSION_OPPORTUNITIES",
"rank": 1,
"bid": 316,
"suggestedBid": {
"rangeStart": 128,
"rangeMedian": 316,
"rangeEnd": 483
}
}
],
"translation": "recarga de jabón de manos espumoso",
"userSelectedKeyword": false,
"searchTermImpressionRank": null,
"searchTermImpressionShare": null,
"recId": "b3c46375-1534-49bb-a25f-99f4199cc97f"
},
{
"keyword": "foaming soap",
"bidInfo": [
{
"matchType": "PHRASE",
"theme": "CONVERSION_OPPORTUNITIES",
"rank": 2,
"bid": 456,
"suggestedBid": {
"rangeStart": 117,
"rangeMedian": 456,
"rangeEnd": 830
}
},
{
"matchType": "BROAD",
"theme": "CONVERSION_OPPORTUNITIES",
"rank": 2,
"bid": 205,
"suggestedBid": {
"rangeStart": 153,
"rangeMedian": 205,
"rangeEnd": 336
}
},
{
"matchType": "EXACT",
"theme": "CONVERSION_OPPORTUNITIES",
"rank": 2,
"bid": 143,
"suggestedBid": {
"rangeStart": 85,
"rangeMedian": 143,
"rangeEnd": 152
}
}
],
"translation": "jabón espumoso",
"userSelectedKeyword": false,
"searchTermImpressionRank": null,
"searchTermImpressionShare": null,
"recId": "d8c36993-df47-4b26-a8f0-a9c166ebc878"
}
],
"impactMetrics": null
}🟢200Success for ASINS
修改于 2025-03-16 02:19:30