Amazon Ads API
首页SP-API广告APISP-API 开发者申请
其他资源
  • 问答社区
  • AI智能助手
首页SP-API广告APISP-API 开发者申请
其他资源
  • 问答社区
  • AI智能助手
  1. Campaigns
  • 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
        POST
      • List campaigns
        POST
      • Update campaign
        PUT
      • Delete campaign
        POST
    • 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
        • 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. Campaigns

List campaigns

POST
/sb/v4/campaigns/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.sbcampaignresource.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/campaigns/list' \
--header 'Amazon-Advertising-API-ClientId: {{client_id}}' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Amazon-Advertising-API-Scope: {{profileId}}' \
--header 'Accept: application/vnd.sbcampaignresource.v4+json'

返回响应

🟢200Success
application/json
Body
campaigns
array [object {10}] 
必需
bidding
object 
必需
brandEntityId
string 
必需
budget
integer 
必需
budgetType
string 
必需
campaignId
string 
必需
isMultiAdGroupsEnabled
boolean 
必需
name
string 
必需
productLocation
string 
必需
startDate
string 
必需
state
string 
必需
totalCount
integer 
必需
示例
{
    "campaigns": [
        {
            "bidding": {
                "bidOptimization": true,
                "bidOptimizationStrategy": "MAXIMIZE_IMMEDIATE_SALES"
            },
            "brandEntityId": "ENTITY21DWFJV45CH71",
            "budget": 10,
            "budgetType": "DAILY",
            "campaignId": "203755086457166",
            "isMultiAdGroupsEnabled": true,
            "name": "Test v4 campaign store 2",
            "productLocation": "SOLD_ON_AMAZON",
            "startDate": "2023-05-21",
            "state": "PAUSED"
        },
        {
            "bidding": {
                "bidOptimization": true,
                "bidOptimizationStrategy": "MAXIMIZE_IMMEDIATE_SALES"
            },
            "brandEntityId": "ENTITY21DWFJV45CH71",
            "budget": 10,
            "budgetType": "DAILY",
            "campaignId": "222860667662817",
            "isMultiAdGroupsEnabled": true,
            "name": "Test v4 campaign",
            "productLocation": "SOLD_ON_AMAZON",
            "startDate": "2023-05-21",
            "state": "PAUSED"
        }
    ],
    "totalCount": 2
}
修改于 2025-03-16 02:19:30
上一页
Create campaigns
下一页
Update campaign
Built with