Amazon Sponsored Brands API: ListMigrations for Product Collection

Amazon Advertising has released the ListMigrations API for Sponsored Brands, enabling programmatic identification and migration of deprecated Product Collection ads to replacement formats with filtering and pagination support.

var(--variable-P9pGqVWeU)

Amazon's new ListMigrations API allows advertisers to programmatically retrieve recommended replacement ads for deprecated Product Collection campaigns through the Amazon Sponsored Brands API. The endpoint supports filtering, pagination, and batch retrieval—critical for sellers maintaining automated campaign workflows as Amazon sunsets older ad formats.

Key Takeaways: What Advertisers Need to Know

  • Programmatic migration: The ListMigrations API returns replacement ad recommendations for deprecated Product Collection campaigns with full pagination support for accounts managing hundreds or thousands of ads

  • Filtering capabilities: Advertisers can query by migration state to retrieve only pending, completed, or action-required transitions—essential for workflow automation

  • Mandatory transition: Product Collection ads are being phased out; failing to migrate risks campaign pauses and lost advertising coverage

  • API-first approach: This release signals Amazon's push toward automated campaign management, requiring sellers to integrate new endpoints or risk manual migration bottlenecks

Amazon's new ListMigrations API allows advertisers to programmatically retrieve recommended replacement ads for deprecated Product Collection campaigns through the Amazon Sponsored Brands API. The endpoint supports filtering, pagination, and batch retrieval—critical for sellers maintaining automated campaign workflows as Amazon sunsets older ad formats.

Understanding the Amazon Sponsored Brands API Migration Context

Amazon regularly deprecates older ad formats as it evolves its advertising platform. Product Collection ads—an earlier Sponsored Brands format that displayed a curated set of products—are being replaced by more flexible and performant ad types including Sponsored Brands video, Store spotlight, and product collection variations with enhanced creative controls.

[[TQ_YOUTUBE:DJme98GrAkM]]

The ListMigrations API release represents Amazon's first programmatic solution for large-scale ad format transitions. Previously, advertisers faced manual campaign recreation or relied on bulk spreadsheet exports—tedious and error-prone for accounts with extensive campaign portfolios.

Automation imperative: Sellers managing 500+ Sponsored Brands campaigns can now retrieve and process migration recommendations in seconds rather than hours of manual review.

Why Amazon Is Sunsetting Product Collection Ads

Amazon Advertising hasn't published explicit deprecation reasoning, but industry analysis points to several factors:

  • Performance gaps: Newer Sponsored Brands formats show improved engagement metrics in advertiser testing

  • Creative limitations: Product Collection ads lacked video support and dynamic creative optimization available in current formats

  • Platform consolidation: Reducing format fragmentation simplifies Amazon's ad serving infrastructure and reporting systems

How the ListMigrations API Works

The new endpoint integrates into the existing Amazon Sponsored Brands API structure. Advertisers authenticate using standard Amazon Advertising API credentials (client ID, client secret, refresh token) and make GET requests to the listMigrations resource.

Request Structure and Parameters

The API accepts several key parameters for tailored retrieval:

  • startIndex: Pagination offset for large result sets (default 0)

  • count: Number of migration records per page

  • stateFilter: Optional filter to retrieve migrations by status (pending, completed, requires_action)

  • profileId: Amazon Advertising profile identifier for multi-account management

Parameter

Type

Purpose

Example Value

startIndex

Integer

Pagination offset

0, 100, 200

count

Integer

Results per page

50, 100

stateFilter

String

Migration status

pending, completed

profileId

String

Ad account identifier

1234567890

Response Format and Data Structure

The API returns JSON objects containing migration recommendations. Each record includes:

  • Original campaign ID: The deprecated Product Collection ad identifier

  • Recommended replacement ID: The new campaign or ad group Amazon suggests as the replacement

  • Migration state: Current status (pending review, ready to migrate, completed)

  • Metadata: Campaign name, daily budget, targeting settings carried forward

Advertisers can then use these replacement IDs with existing Sponsored Brands update endpoints to complete the migration programmatically.

Integration Strategies for Sellers and Agencies

Immediate action required: Advertisers using custom dashboards, third-party tools, or homegrown automation scripts must integrate the ListMigrations endpoint to maintain campaign continuity.

[[TQ_IMG:https://framerusercontent.com/images/Ygf4oi2QKM4Y0wYxKiJE56aaw.png|How the ListMigrations API Works]]

Manual migration through Seller Central remains an option but scales poorly for accounts with dozens of active Product Collection campaigns.

Step-by-Step Integration Workflow

  1. Audit current campaigns: Query your existing Sponsored Brands campaigns to identify Product Collection ads scheduled for deprecation

  2. Call ListMigrations API: Retrieve the full list of recommended replacements with pagination for large portfolios

  3. Review migration recommendations: Parse the response to validate replacement campaigns match your targeting and budget requirements

  4. Automate updates: Use the Sponsored Brands update endpoints to activate replacement campaigns and pause deprecated ads

  5. Monitor performance: Track key metrics post-migration to ensure replacement campaigns maintain or improve performance

Agency advantage: For agencies managing multiple Amazon Advertising accounts, the profileId parameter enables batch retrieval across all clients—a single integration handles hundreds of migrations.

Tools and Platforms Requiring Updates

Several categories of Amazon advertising technology must integrate the new API:

  • Bid management platforms: Tools like Perpetua, Teikametrics, and Pacvue need ListMigrations support to prevent campaign pauses

  • Custom dashboards: Internal BI tools pulling Sponsored Brands data should incorporate migration status checks

  • Workflow automation: Rule-based campaign creation scripts must handle replacement ad creation

  • AI-powered optimization: TrackIQ and similar AI business analysts require ListMigrations integration to maintain uninterrupted campaign intelligence

Technical Considerations and Best Practices

Integrating the ListMigrations API requires attention to several technical details beyond basic endpoint calls.

Rate Limiting and Pagination Strategy

Amazon Advertising APIs enforce rate limits to prevent system overload. Best practice: implement exponential backoff for 429 (Too Many Requests) responses and paginate through large migration lists in manageable batches to stay within throttling thresholds.

For agencies managing 50+ client accounts, stagger API calls across multiple minutes rather than simultaneous requests to avoid triggering security blocks.

Error Handling and Migration State Management

The API may return migrations in various states requiring different handling:

Migration State

Meaning

Required Action

pending

Migration recommended but not yet initiated

Review and approve replacement

requires_action

Manual intervention needed (budget conflicts, targeting issues)

Adjust settings before migration

completed

Replacement campaign active

Archive deprecated campaign

failed

Migration encountered errors

Retry with updated parameters

Log all migration attempts with timestamps and state transitions. This audit trail proves invaluable when troubleshooting performance discrepancies between deprecated and replacement campaigns.

Impact on Campaign Performance and Metrics Continuity

One critical concern for advertisers: Will historical performance data transfer to replacement campaigns? Amazon has not published explicit guidance, but based on previous format migrations, expect:

  • Separate reporting: Replacement campaigns typically appear as new entities in Sponsored Brands reports, creating a historical break in trend analysis

  • Learning period reset: Amazon's algorithm treats new campaigns as distinct, potentially requiring 7-14 days to optimize bidding and placement

  • Keyword and targeting preservation: The API carries forward targeting settings, but quality scores and bid adjustments may reset

Performance transition alert: Advertisers commonly experience CPC fluctuations during the first week post-migration as Amazon's bidding algorithm recalibrates for replacement campaigns.

Mitigating Migration Performance Risks

To minimize disruption during the transition:

  1. Run parallel campaigns: Keep deprecated Product Collection ads active for 7-10 days while replacement campaigns accumulate data

  2. Adjust bids conservatively: Start replacement campaigns at 90% of historical bids and increase incrementally based on performance

  3. Monitor daily: Check impression share, conversion rate, and ACOS metrics daily during the first two weeks post-migration

  4. Preserve budget allocation: Transfer daily budgets proportionally rather than consolidating multiple deprecated campaigns into a single replacement

Strategic Implications for Amazon Advertising Automation

The ListMigrations API release signals a broader shift in how Amazon Advertising expects advertisers to manage campaigns.

[[TQ_IMG:https://framerusercontent.com/images/6jGaYVBuHzM19bdmrhBjSeUm2u8.png|Technical Considerations and Best Practices]]

Manual campaign management is becoming increasingly impractical as Amazon introduces more format variations, targeting options, and optimization features.

The API-First Advertising Future

Amazon's product roadmap points toward several trends:

  • Automated format transitions: Future deprecations will likely follow the ListMigrations pattern, requiring programmatic integration as table stakes

  • Real-time bidding adjustments: APIs enabling sub-hourly bid changes based on inventory levels, competitor activity, and conversion signals

  • AI-driven creative optimization: Programmatic A/B testing of headlines, images, and product selections through API endpoints

Sellers without API integration capabilities face a growing competitive disadvantage. The manual campaign management window is closing—invest in automation infrastructure now or risk falling behind competitors leveraging programmatic workflows.

Building Internal API Capabilities vs. Third-Party Solutions

Brands and agencies face a build-vs-buy decision for Amazon Sponsored Brands API integration:

Approach

Pros

Cons

Internal development

Full control, custom workflows, no recurring fees

Requires engineering resources, ongoing maintenance, slow iteration

Third-party platforms

Immediate availability, proven reliability, vendor support

Monthly costs, less customization, vendor dependency

Hybrid approach

Core automation via API + human oversight for strategic decisions

Requires coordination between tools and team workflows

For most mid-market sellers, a hybrid model makes sense: use third-party platforms for routine migrations and bid management while building internal expertise for strategic campaign architecture.

Implementation Timeline and Migration Deadlines

Amazon has not published a hard deadline for Product Collection ad deprecation, but based on previous format transitions, advertisers should expect a transition window measured in months rather than years.

Act within 30 days to avoid last-minute scrambles when Amazon eventually announces service termination dates.

Recommended Action Plan

  • Week 1-2: Audit current Product Collection campaigns and estimate migration scope

  • Week 3-4: Integrate ListMigrations API into existing automation tools or select a third-party platform

  • Week 5-6: Execute pilot migrations on 10-20% of campaigns to validate workflow and performance

  • Week 7-8: Complete bulk migration with daily monitoring and performance adjustments

Agencies managing multiple client accounts should prioritize high-spend advertisers first—a campaign pause on a $10,000/day account creates immediate revenue impact, while smaller accounts can migrate later in the timeline.

Connecting Campaign Data to Business Intelligence

The ListMigrations API is just one piece of the larger Amazon advertising data ecosystem. Campaign migrations create data continuity challenges—your BI dashboards, attribution models, and forecasting systems all rely on consistent historical campaign identifiers.

Modern Amazon sellers need infrastructure that automatically detects API changes and adapts data pipelines accordingly. TrackIQ's Model Context Protocol integration enables AI assistants to query live Amazon Ads data and detect campaign structure changes, ensuring your business intelligence remains accurate through format transitions.

Maintaining Reporting Continuity Post-Migration

To preserve year-over-year performance comparisons despite campaign ID changes:

  1. Create mapping tables: Log relationships between deprecated Product Collection IDs and replacement campaign IDs

  2. Aggregate by product: Report at the ASIN or product category level rather than campaign-specific metrics

  3. Normalize time periods: Compare pre-migration and post-migration performance using rolling 30-day windows rather than calendar months

  4. Document transition dates: Annotate all dashboards and reports with migration completion dates to provide context for performance shifts

With proper data mapping and the right automation tools, the ListMigrations API transition becomes an opportunity to modernize your advertising infrastructure rather than a disruptive obligation.

[[TQ_SOURCES]]Amazon Advertising API Release Notes - ListMigrations API | https://advertising.amazon.com/API/docs/en-us/release-notes/index; Amazon Advertising API Documentation | https://advertising.amazon.com/API/docs; Amazon Seller Central | https://sellercentral.amazon.com; Amazon Advertising Solutions | https://advertising.amazon.com

Jacob Heinz

Frequently asked questions

What is the Amazon Sponsored Brands ListMigrations API?

The ListMigrations API is a new endpoint in the Amazon Sponsored Brands API that returns recommended replacement ads for deprecated Product Collection campaigns. It supports filtering by migration state and pagination for large-scale retrievals.

Why does Amazon require Product Collection ad migration?

Amazon is deprecating the Product Collection ad format in favor of newer Sponsored Brands formats that offer better performance metrics and creative flexibility. Advertisers must migrate to maintain active campaigns and avoid service disruptions.

How do I integrate the ListMigrations API into my workflow?

You authenticate using existing Amazon Advertising API credentials, call the listMigrations endpoint with optional filters and pagination parameters, parse the JSON response containing migration recommendations, and use the replacement ad IDs to update your campaigns programmatically.

Can I filter migrations by specific campaign states?

Yes, the API supports filtering by migration state parameters, allowing you to retrieve only pending migrations, completed transitions, or migrations requiring action—streamlining workflow automation for large accounts.

What happens if I don't migrate Product Collection ads?

Deprecated Product Collection ads will eventually stop serving impressions. Amazon may pause or archive unmigrated campaigns, resulting in lost traffic, reduced sales velocity, and gaps in your advertising coverage until you manually recreate campaigns.

The AI Business Analyst for Amazon sellers & agencies.

Built in Oklahoma, powered by your data.

© 2026 TrackIQ. All rights reserved.

Made for Amazon sellers & agencies.

The AI Business Analyst for Amazon sellers & agencies.

Built in Oklahoma, powered by your data.

© 2026 TrackIQ. All rights reserved.

Made for Amazon sellers & agencies.

The AI Business Analyst for Amazon sellers & agencies.

Built in Oklahoma, powered by your data.

© 2026 TrackIQ. All rights reserved.

Made for Amazon sellers & agencies.