Amazon Ads API
首页SP-API广告APISP-API 开发者申请
其他资源
  • 问答社区
  • AI智能助手
首页SP-API广告APISP-API 开发者申请
其他资源
  • 问答社区
  • AI智能助手
  1. Sponsored Brands
  2. Targeting
  3. Recommendations
  • Auth
    • Auth grant login
    • Access token from auth grant code
    • Access token from refresh token
  • Accounts
    • Profiles
    • Manager accounts
  • First call
    • List SB campaigns
    • List SD campaigns
    • List SP campaigns
  • Reporting
    • DSP report
      • Request DSP report
      • DSP report status
    • Sponsored ads V3
      • Create report
      • Report status
    • Sponsored ads V2
      • Request SB report
      • Request SD report
      • Report status
      • Download report
  • Snapshots
    • Sponsored Products
      • Request SP snapshot
      • SP snapshot status
      • Download SP snapshot
    • Sponsored Display
      • Request SD snapshot
      • SD snapshot status
      • Download SD snapshot
    • Sponsored Brands
      • Request SB snapshot
      • SB snapshot status
      • Download SB snapshot
  • Test accounts
    • Create test account
    • Check account creation status
  • Amazon Marketing Stream
    • Create Stream subscription
    • List Stream subscriptions
    • Get Stream subscription by ID
    • Update Stream subscription
  • Amazon Marketing Cloud
    • Administration
      • Accounts
        • List all AMC 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
      • Workflows
        • Create a workflow
        • Create a workflow with custom parameters
        • List all workflows in a specific instance
        • Get the requested workflow
        • Update the requested workflow
        • Delete the requested workflow
      • Schedules
        • Create a new schedule
        • List all schedules
        • Gets the requested schedule
        • Updates the requested schedule
        • Deletes the requested schedule
      • Workflow executions
        • Creates a new workflow execution
        • Returns a list of workflow executions
        • Gets status information about the requested workflow execution.
        • Updates the requested workflow execution.
        • Retrieves pre-signed url for downloading workflow execution results from S3
    • 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
        • Creates lookalike audience execution metadata information.
  • Sponsored Products
    • Campaigns
      • List campaigns
      • Create campaigns
      • Delete campaigns
      • Update campaigns
    • Ad groups
      • Create ad groups
      • Delete ad groups
      • List ad groups
      • Update ad groups
    • Product ads
      • List product ads
      • Create product ads
      • Update product ad
      • Delete product ads
    • Product targeting
      • List targets
      • Create targets
      • Update targets
      • Delete targets
      • Product recommendatios
      • Category recommendations
    • Keywords
      • Create Keywords
      • List keywords
      • Update keywords
      • Delete keywords
      • Keyword Recommendation for existing adGroup
    • Theme-based bid recommendations
      • Get recommendations
    • Negative keywords
      • Create negative keywords
      • Update negative keywords
      • Delete negative keywords
      • List negative keywords
    • Campaign negative keywords
      • Create campaign negative keywords
      • Update campaign negative keywords
      • Delete campaign negative keywords
      • List campaign negative keywords
    • Negative targets
      • Create negative targets
      • List negative targets
      • Update negative targets
      • Delete negative targets
    • Campaign negative targets
      • Create campaign negative targets
      • List campaign negative target
      • Update campaign negative targets
      • Delete campaign negative targets
    • Budget recommendations and missed opportunities
      • Get budget recommendations and missed opportunities
    • Budget rules
      • Create budget rules
      • Associate rule to campaign
      • Get recommended events
      • Get budget rules
      • Get budget rules by campaign
      • Get budget history
  • Sponsored Brands
    • Campaigns
      • Create campaigns
      • List campaigns
      • Update campaign
      • Delete campaign
    • Ad groups
      • Create ad groups
      • List ad groups
      • List ad groups Copy
      • Update ad groups
      • Delete ad groups
    • Ads
      • Create product collection ad
      • Create product collection extended
      • Create video ad
      • Create brand video ad
      • Create store spotlight ad
      • List ads
      • Update ads
      • Delete ads
    • Targeting
      • Recommendations
        • Get product recommendations
          POST
        • Get keyword recommendations
          POST
        • Recommended categories for targeting
          POST
        • Get bid recommendations for targets
          POST
      • Theme targeting
        • Create theme targeting
        • Update theme targets
        • List themes
      • Create keywords
        POST
      • Update keyword
        PUT
      • Get keyword
        GET
      • Delete keyword
        DELETE
      • Create negative keywords
        POST
      • Update negative keyword
        PUT
      • Get negative keyword
        GET
      • Delete negative keyword
        DELETE
      • Create product targets
        POST
      • Update a product target
        PUT
      • Get product target
        GET
      • Delete product target
        DELETE
      • Create negative product target
        POST
      • Update negative product target
        PUT
      • Get negative product target
        GET
      • Delete negative product target
        DELETE
      • Get all categories
        GET
      • Get category refinements
        GET
    • Ad creatives
      • Store spotlight
      • Brand video
      • Product collection
      • Product collection Extended
      • Video
      • List ad creatives
    • Get brands
      GET
    • Get landing page ASINS
      GET
  • Sponsored Display
    • Campaigns
      • Create campaigns
      • List campaigns
    • Ad groups
      • Create ad groups
      • Get ad groups
    • Product ads
      • Create product ads
      • Get product ads
    • Targeting
      • Create targets
      • Get targets
      • Audience taxonomy
      • Audience discovery
    • Creatives
      • Add creatives
      • List creatives
      • Update creatives
    • Locations
      • Locations
      • Locations
  • Stores
    • Get stores
    • Insight metrics
  • Product metadata
    • Get product metadata
    • Get product eligibility
  • Budget rules
    • SP
      • Create budget rules
      • Associate budget rules to campaign
      • Get recommended events
      • All budget rules
      • Update budget rules
      • Disassociate budget rule from campaign
      • Campaigns associated with a rule
      • Budget rule by ID
      • Rules associated with a campaign
    • SD
      • Create budget rules
      • Associate budget rules to campaign
      • All budget rules
      • Update budget rules
      • Disassociate budget rule from campaign
      • Campaigns associated with a rule
      • Budget rule by ID
      • Rules associated with a campaign
    • SB
      • Create budget rules
      • Associate budget rules to campaign
      • Get recommended events
      • All budget rules
      • Update budget rules
      • Disassociate budget rule from campaign
      • Campaigns associated with a rule
      • Budget rule by ID
      • Rules associated with a campaign
  • Budget usage
    • Sponsored Products
    • Sponsored Brands
    • Sponsored Display
  • Creative asset library
    • Create URL
    • Upload file
    • Register asset
    • Assets
    • Assets search
  • Locations
    • Browse locations
  • Exports
    • Request campaign export
    • Request ad group export
    • Request target export
    • Request ad export
    • Exports status
  • Sponsored TV
    • Campaign
      • Create Campaign
      • List Campaign
      • Delete Campaign
      • Update Campaign
    • AdGroup
      • Create AdGroup
      • List AdGroup
      • Update AdGroup
      • Delete AdGroup
    • Ad
      • Create Ad
      • List Ad
      • Delete Ad
      • Update Ad
    • Creatives
      • Create Creatives
      • List Creatives
      • List Creatives Moderation
      • List Creatives Moderations Policy Violations
      • Preview Creatives
  • Amazon DSP
    • Persona builder
      • Banded sizes
      • Demographics
      • Prime Video
      • Top categories purchased
      • Top overlapping audiences
  • Partner opportunities
    • List opportunities
    • Get opportunity file
  1. Sponsored Brands
  2. Targeting
  3. Recommendations

Get keyword recommendations

POST
/sb/recommendations/keyword
最后修改时间：2025-03-16 02:19:30
责任人：未设置

请求参数

Header 参数
Amazon-Advertising-API-ClientId
string 
必需
示例值:
{{client_id}}
Authorization
string 
必需
示例值:
Bearer {{access_token}}
Amazon-Advertising-API-Scope
string 
必需
示例值:
{{profileId}}
Body 参数application/json
url
string 
必需
maxNumSuggestions
string 
必需
creativeType
string 
必需
creativeAsins
array[string]
必需
locale
string 
必需
示例
{
  "url": "https://www.amazon.com/stores/page/1F55C506-459C-42B7-885B-86A3EA96A582",
  "maxNumSuggestions": "3",
  "creativeType": "PRODUCT_COLLECTION",
  "creativeAsins": [
    "B00JVTNWB0",
    "B0787FVB5F",
    "B004QF0TFQ"
  ],
  "locale": "zh_CN"
}

示例代码

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/sb/recommendations/keyword' \
--header 'Amazon-Advertising-API-ClientId: {{client_id}}' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Amazon-Advertising-API-Scope: {{profileId}}' \
--header 'Content-Type: application/json' \
--data-raw '{
   "url": "https://www.amazon.com/stores/page/1F55C506-459C-42B7-885B-86A3EA96A582",
  "maxNumSuggestions": "3",
  "creativeType": "PRODUCT_COLLECTION",
  "creativeAsins" : [
    "B00JVTNWB0",
    "B0787FVB5F",
    "B004QF0TFQ"
  ],
  "locale": "zh_CN"
}'

返回响应

🟢200Get keyword recommendations for list of ASINS
application/json
Body
array of:
recommendationId
string 
必需
type
string 
必需
value
string 
必需
translation
string 
必需
matchType
string 
必需
searchTermImpressionShare
null 
必需
searchTermImpressionRank
null 
必需
示例
[
  {
    "recommendationId": "8b6e905435fc700f2033de731a429429",
    "type": "addKeyword",
    "value": "mens socks",
    "translation": "男士袜子",
    "matchType": "PHRASE",
    "searchTermImpressionShare": null,
    "searchTermImpressionRank": null
  },
  {
    "recommendationId": "5cb57c0e663281f2c86fb2718dda1e6e",
    "type": "addKeyword",
    "value": "socks for men",
    "translation": "男士袜子",
    "matchType": "PHRASE",
    "searchTermImpressionShare": null,
    "searchTermImpressionRank": null
  },
  {
    "recommendationId": "fbce90ea015b6bf23e1f02cd9a0d4813",
    "type": "addKeyword",
    "value": "mens adidas socks",
    "translation": "男士阿迪达斯袜",
    "matchType": "PHRASE",
    "searchTermImpressionShare": null,
    "searchTermImpressionRank": null
  }
]
🟢200Get keyword recommendations for URL
修改于 2025-03-16 02:19:30
上一页
Get product recommendations
下一页
Recommended categories for targeting
Built with