Amazon Ads API
首页SP-API广告APISP-API 开发者申请
其他资源
  • 问答社区
  • AI智能助手
首页SP-API广告APISP-API 开发者申请
其他资源
  • 问答社区
  • AI智能助手
  1. Instances
  • 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
          POST
        • List all instances
          GET
        • List information about the requested instance
          GET
        • Update instance details
          PUT
        • Update AWS account metadata in the requested instance
          POST
        • List advertisers in instance
          GET
        • Create advertiser update
          POST
        • Get advertiser update
          GET
        • Gets advertiser information about the requested AMC instance
          GET
        • Delete AMC instance
          DELETE
    • 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
        • 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 landing page ASINS
  • 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. Instances

List all instances

GET
/amc/instances
最后修改时间：2025-03-16 02:19:30
责任人：未设置
Gets information about all AMC instances that the requesting entity has access to. Information for each instance includes the name, creation status, and the entities with access to the instance.

请求参数

Query 参数
nextToken
string 
必需
Optional. Token to retrieve subsequent page of results.
limit
string 
可选
Optional. Limits the number of items to return in the response. Max value is 100. Defaults to 100.
示例值:
<string>
Header 参数
Amazon-Advertising-API-ClientId
string 
必需
(Required) The identifier of a client associated with an Amazon Developer account.
示例值:
{{client_id}}
Authorization
string 
必需
示例值:
Bearer {{access_token}}
Amazon-Advertising-API-MarketplaceId
string 
必需
示例值:
{{marketplace_id}}
Amazon-Advertising-API-AdvertiserId
string 
必需
示例值:
{{advertiser_id}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://advertising-api.amazon.com/amc/instances?nextToken=' \
--header 'Amazon-Advertising-API-ClientId: {{client_id}}' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Amazon-Advertising-API-MarketplaceId: {{marketplace_id}}' \
--header 'Amazon-Advertising-API-AdvertiserId: {{advertiser_id}}'

返回响应

🟢200Gets information about all AMC instances
application/json
Body
instances
array [object {14}] 
必需
instanceId
string 
可选
instanceName
string 
可选
instanceType
string 
可选
customerCanonicalName
string 
可选
creationStatus
string 
可选
creationDatetime
string 
可选
s3BucketName
string 
可选
awsAccountId
string 
可选
entities
array[string]
可选
dataUploadAwsAccountId
string 
可选
apiEndpoint
string 
可选
acrCollaboration
null 
可选
optionalDatasets
array [object {2}] 
可选
advertiserTypes
array[string]
可选
nextToken
null 
必需
示例
{
    "instances": [
        {
            "instanceId": "amcr1aaaa1a",
            "instanceName": "myinstance",
            "instanceType": "STANDARD",
            "customerCanonicalName": "Sample Instance",
            "creationStatus": "COMPLETED",
            "creationDatetime": "2024-03-29T08:12:11.572511Z",
            "s3BucketName": "amc-sample-instance-bucket",
            "awsAccountId": "",
            "entities": [
                "NA"
            ],
            "dataUploadAwsAccountId": "811639200769",
            "apiEndpoint": "https://advertising-api.amazon.com",
            "acrCollaboration": null,
            "optionalDatasets": [
                {
                    "label": "CASPIAN_DIM_CUTOVER",
                    "activationTime": "2024-03-27T12:07:25.614Z"
                },
                {
                    "label": "CASPIAN_DIM_CUTOVER_CONVERSIONS",
                    "activationTime": "2024-03-27T12:07:25.614Z"
                },
                {
                    "label": "CASPIAN_FACT_CUTOVER",
                    "activationTime": "2024-03-27T12:07:25.614Z"
                },
                {
                    "label": "CASPIAN_ONLY",
                    "activationTime": "2024-03-27T12:07:25.614Z"
                },
                {
                    "label": "CONVERSIONS_EXPOSURE_V3",
                    "activationTime": "2024-06-27T13:51:29.259Z"
                }
            ],
            "advertiserTypes": [
                "DISPLAY",
                "SPONSORED_ADS"
            ]
        }
    ],
    "nextToken": null
}
上一页
Create an instance
下一页
List information about the requested instance
Built with