Amazon DSP forecasting API reaches general availability

Amazon's forecasting API for Amazon DSP campaigns has transitioned from open beta to general availability. The tool provides programmatic access to real-time forecasts previously available only through the ADSP Campaign Manager interface.

Built on the Amazon Ads API v1 data model, the forecasting API delivers campaign-level performance projections across multiple metrics. According to technical specifications released in the Advanced Tools Center documentation, the system supports predictions for spend, reach, cost-per-click, cost-per-acquisition, and return on ad spend at the campaign flight level.

The API architecture operates through the DSPRetrieveCampaignForecast endpoint, accessible via POST requests to /adsApi/v1/retrieve/campaignForecasts/dsp. Implementation requires two header parameters: Amazon-Ads-AccountId for advertiser account identification and Amazon-Ads-ClientId for Login with Amazon authentication. The request body accepts campaign forecast descriptions in application/json format, with the system returning either successful forecasts or error responses through a 207 multi-status code.

Technical documentation reveals the API provides forecasts for both new campaign orders and existing orders currently spending budget. This dual capability addresses distinct planning scenarios. New order forecasting enables budget allocation decisions during campaign development, while active order projections help advertisers adjust strategy mid-flight based on performance trajectories.

The forecasting widgets available through the Campaign Manager interface serve as the data foundation for API responses. The programmatic access eliminates manual data collection from the user interface, enabling integration with third-party campaign management platforms and automated reporting systems. This architectural approach maintains consistency between UI-based forecasts and API-delivered predictions.

Amazon DSP has systematically expanded its data access capabilities throughout 2024 and 2025. The platform introduced modeled attribution for off-Amazon conversions in August 2024, automatically incorporating estimated conversions into API endpoints. That implementation established precedent for comprehensive API integration across Amazon DSP measurement features.

Response handling follows standard API patterns with seven potential error codes beyond the success state. Bad requests return 400 status codes, while authentication failures generate 401 responses. The system implements rate limiting through 429 status codes, with content size restrictions enforced via 413 responses. Server-side errors manifest as 500, 502, 503, or 504 codes depending on the specific infrastructure issue.

The technical specifications indicate version 1 status and OpenAPI 3.0.2 compliance, suggesting long-term API stability. OpenAPI specification files are available for download, enabling automated client generation and integration testing. This standardization reduces development friction for advertisers building custom campaign management infrastructure.

Performance forecasting has become increasingly critical as programmatic advertising complexity grows. Amazon DSP reached a monthly ad-supported audience of 275 million customers in the United States as of October 2024, creating substantial inventory across which advertisers must allocate budgets. Accurate forecasting enables data-driven decisions about campaign scope and expected outcomes before budget commitment.

The API complements other recent Amazon DSP API launches. Geographic Insights and Activation API entered beta in 2025, providing programmatic control over location-based bid adjustments at the postal code level. That system includes six distinct endpoints for managing geographic optimization strategies, demonstrating Amazon's commitment to comprehensive API coverage across DSP functionality.

Campaign planning workflows benefit from programmatic forecast access through reduced manual intervention. Agencies managing multiple client accounts can integrate forecasting data into centralized dashboards, eliminating repeated Campaign Manager logins. Ad tech activation partners managing Amazon DSP campaigns on behalf of advertisers gain efficiency through automated forecast retrieval, enabling faster campaign development and client reporting.

The forecasting API operates within Amazon's broader measurement ecosystem. Amazon Marketing Cloud provides clean room analytics for audience analysis, while the new forecasting tool focuses specifically on forward-looking campaign projections. These complementary capabilities enable comprehensive planning combining historical performance analysis with future outcome predictions.

Third-party platform integrations stand to benefit from standardized API access. Campaign management platforms like Skai and Pacvue, which Amazon lists as activation partners, can incorporate real-time forecasts into their optimization algorithms. This integration enables automated budget pacing adjustments based on projected performance against advertiser goals, reducing the manual oversight required for campaign success.

The general availability designation indicates Amazon has completed beta testing and performance validation. Beta programs typically identify edge cases and performance bottlenecks before wider release. The transition suggests the forecasting API has demonstrated reliability across diverse advertiser use cases and campaign configurations during testing phases.

Documentation structure provides implementation guidance through request and response samples. The payload examples demonstrate proper JSON formatting for campaign forecast description arrays, while response samples illustrate both success and error states. This comprehensive documentation reduces integration complexity for development teams implementing forecasting capabilities.

Amazon announced frequency groups reporting capabilities in December 2024, enabling cross-campaign reach measurement. The forecasting API complements this reporting enhancement by providing forward-looking projections that incorporate frequency management impacts on reach and spend efficiency.

Server infrastructure supporting the API remains consistent with other Amazon Ads API v1 endpoints. This architectural consistency enables developers familiar with existing Amazon API implementations to quickly integrate forecasting capabilities using established authentication and request patterns. The uniform approach reduces learning curves and accelerates adoption across advertiser technology stacks.

The forecasting methodology likely incorporates machine learning models analyzing historical campaign performance across Amazon's advertising network. Similar Audiences in Amazon DSP uses AI to identify targeting opportunities, demonstrating Amazon's investment in machine learning for advertising optimization. Forecasting systems typically leverage comparable algorithmic approaches to predict future outcomes based on historical patterns and current campaign parameters.

Campaign flight level granularity enables precise planning for time-bound advertising initiatives. Seasonal campaigns, product launches, and promotional periods benefit from detailed forecasting at the flight level rather than aggregate campaign projections. This granularity supports sophisticated budget allocation strategies that account for varying performance across campaign duration.

The API's inclusion of both new and existing order forecasting addresses the complete campaign lifecycle. Planning-phase forecasts inform budget requests and goal setting, while in-flight forecasts enable course correction before budget exhaustion. This comprehensive coverage ensures advertisers maintain data-driven decision making throughout campaign execution.

Conversion Path Reporting launched in beta in January 2025, providing 30-day customer journey analysis across Amazon ad formats. The forecasting API operates at a different stage of campaign management, providing predictions before and during campaign execution rather than historical path analysis. Together, these tools enable comprehensive campaign planning and retrospective analysis.

Integration requirements remain minimal compared to complex authentication schemes. The two-header parameter structure follows standard OAuth patterns familiar to developers working with modern APIs. Amazon-Ads-AccountId and Amazon-Ads-ClientId provide sufficient context for request routing and authorization without excessive overhead in each API call.

Real-time forecast availability distinguishes the API from batch-processed reporting systems. Advertisers can query forecasts on-demand during campaign planning sessions, enabling interactive decision-making about budget levels and performance expectations. This immediacy accelerates planning cycles compared to scheduled report delivery or manual UI navigation.

The technical documentation notes that retrievals by ID offer superior performance compared to query-based approaches. This optimization guidance suggests Amazon has implemented database indexing and caching strategies that favor direct ID lookups. Developers should structure applications to maintain campaign IDs and use retrieval endpoints rather than broader query operations where possible.

Amazon DSP introduced consolidated display line-item features in October 2024, combining desktop, mobile, and app display inventory into unified line items. The forecasting API provides predictions across these consolidated inventory types, reflecting the platform's current campaign structure rather than legacy siloed approaches.

Industry context suggests growing demand for programmatic forecast capabilities. Netflix became available in Amazon DSP starting Q4 2025, expanding premium inventory accessible through the platform. As inventory sources multiply, forecasting becomes essential for determining optimal allocation across supply sources and campaign configurations.

The general availability announcement follows Amazon's established pattern of beta testing followed by production release. AI Creative Studio entered beta in October 2024, demonstrating Amazon's approach to incremental feature rollout. Beta programs enable controlled testing with early adopters before platform-wide deployment.

Forecast accuracy improvements likely occurred during the beta period based on advertiser feedback and real-world validation. Beta participants provided data on forecast precision compared to actual campaign outcomes, enabling Amazon to refine prediction algorithms before general release. This iterative refinement process enhances forecast reliability for all advertisers.

Commitments Hub launched in September 2025 with six API endpoints for managing publisher spending agreements. The forecasting API adds predictive capabilities that complement commitment tracking by enabling proactive budget management rather than reactive monitoring of spending progress.

The API documentation appeared in Amazon's Advanced Tools Center, the centralized resource for developer-focused Amazon Ads features. This placement alongside other programmatic capabilities reinforces the API's role in sophisticated campaign automation workflows rather than basic campaign management tasks.

Technical specifications indicate OAS 3.0.2 compliance, referring to OpenAPI Specification version 3.0.2. This standardized API description format enables automated tooling generation, including client libraries, server stubs, and API documentation. The specification format choice reflects industry best practices for enterprise API development.

Campaign Manager parity ensures advertisers receive consistent forecasts regardless of access method. UI-based forecasts and API responses draw from identical data sources and prediction models, preventing discrepancies that could undermine confidence in forecast accuracy. This architectural consistency maintains trust across different access patterns.

The forecasting capability operates independently of other recent DSP enhancements. Microsoft Monetize joined Amazon's Certified Supply Exchange program in October 2025, expanding supply-side platform connections. Forecasting algorithms incorporate performance data across all connected inventory sources, including newly integrated supply partners.

Rate limiting implementation through 429 status codes protects API infrastructure from excessive load while ensuring fair access across advertisers. The documentation does not specify precise rate limits, suggesting they may vary based on advertiser account tier or historical usage patterns. Developers should implement exponential backoff retry logic to handle temporary rate limit situations gracefully.

The transition to general availability signifies production-ready status with Amazon's full support commitment. Beta features carry experimental designation with potential breaking changes, while GA features receive stability guarantees and standard support channels. This status upgrade provides confidence for enterprise advertisers building critical workflows around forecasting capabilities.

Timeline

• January 5, 2021: Amazon launches Amazon Marketing Cloud beta for eligible agencies, advertisers, and tool providers
• February 18, 2024: Amazon DSP Events Manager expands with MMP Integrations
• May 2, 2024: Amazon DSP streamlines campaign management with new overview page
• August 29, 2024: Amazon DSP expands conversion modeling to account for off-Amazon campaign results
• October 19, 2024: Amazon DSP unveils next-gen ad tech for precise reach and performance
• December 23, 2024: New Amazon frequency capping feature adds cross-campaign reach measurement
• January 18, 2025: Amazon introduces conversion tracking to measure advertising path effectiveness
• September 10, 2025: Netflix becomes available in Amazon DSP starting Q4 2025
• September 24, 2025: Amazon launches Commitments Hub for publisher spend management
• October 2025: Amazon DSP forecasting API moves from open beta to general availability

Summary

Who: Amazon Ads released the forecasting API for Amazon DSP advertisers, including both self-service and managed-service accounts. The tool serves agencies, brands, and ad tech activation partners managing programmatic advertising campaigns through Amazon's demand-side platform.

What: The forecasting API provides programmatic access to real-time campaign performance predictions across five key metrics: spend, reach, cost-per-click, cost-per-acquisition, and return on ad spend. The system operates through the Amazon Ads API v1 infrastructure with the DSPRetrieveCampaignForecast endpoint, supporting forecasts for both new campaign orders during planning phases and existing orders currently spending budget. The API delivers campaign flight level projections with OpenAPI 3.0.2 specification compliance.

When: The forecasting API transitioned from open beta to general availability in October 2025. The specific announcement date was not disclosed in the technical documentation, though the general availability designation indicates completion of beta testing and production readiness validation.

Where: The API operates globally across all regions where Amazon DSP maintains presence, including North America, South America, Europe, Middle East, and Asia Pacific markets. Access occurs through Amazon's Advanced Tools Center developer resources, with integration possible into third-party campaign management platforms and advertiser-built systems.

Why: The general availability release addresses advertiser demand for programmatic forecast access beyond manual Campaign Manager interface navigation. Real-time forecasting enables data-driven budget allocation decisions, supports automated campaign planning workflows for agencies managing multiple clients, and facilitates integration with third-party optimization platforms. The API reduces manual intervention in forecast retrieval while maintaining consistency with user interface predictions, enabling sophisticated campaign automation and more efficient planning cycles across the growing complexity of Amazon's programmatic advertising ecosystem.