Amazon Ads API
首页SP-API广告APISP-API 开发者申请
其他资源
  • 问答社区
  • AI智能助手
首页SP-API广告APISP-API 开发者申请
其他资源
  • 问答社区
  • AI智能助手
  1. Ads
  • Auth
    • Auth grant login
      GET
    • Access token from auth grant code
      POST
    • Access token from refresh token
      POST
  • Accounts
    • Profiles
      GET
    • Manager accounts
      GET
  • First call
    • List SB campaigns
      POST
    • List SD campaigns
      GET
    • List SP campaigns
      POST
  • 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
        POST
      • Create product collection extended
        POST
      • Create video ad
        POST
      • Create brand video ad
        POST
      • Create store spotlight ad
        POST
      • List ads
        POST
      • Update ads
        PUT
      • Delete ads
        POST
    • Targeting
      • Recommendations
        • Get product recommendations
        • Get keyword recommendations
        • Recommended categories for targeting
        • Get bid recommendations for targets
      • Theme targeting
        • Create theme targeting
        • Update theme targets
        • List themes
      • 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
      • 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. Ads

List ads

POST
/sb/v4/ads/list
最后修改时间：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}}
Accept
string 
必需
示例值:
application/vnd.sbadresource.v4+json

示例代码

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/v4/ads/list' \
--header 'Amazon-Advertising-API-ClientId: {{client_id}}' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Amazon-Advertising-API-Scope: {{profileId}}' \
--header 'Accept: application/vnd.sbadresource.v4+json' \
--header 'Content-Type: text/plain' \
--data-raw ''

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
修改于 2025-03-16 02:19:30
上一页
Create store spotlight ad
下一页
Update ads
Built with