Skip to main content

​
API v2 Changelog

All notable changes to the Scope3 Agentic API v2 are documented here.

​
February 2026

​
Added

  • POST /api/v2/buyer/advertisers - Create advertiser
  • GET /api/v2/buyer/advertisers/:id - Get advertiser
  • PUT /api/v2/buyer/advertisers/:id - Update advertiser
  • GET /api/v2/buyer/advertisers - List advertisers
  • POST /api/v2/brand/advertisers/:advertiserId/brand - Create brand (manifest URL or JSON)
  • PUT /api/v2/brand/advertisers/:advertiserId/brand - Update brand
  • GET /api/v2/brand/advertisers/:advertiserId/brand - Get brand
Three campaign types with create/update operations:
  • Discovery: POST /api/v2/buyer/campaigns with type: "discover" - Find and select ad products from publishers
  • Audience: POST /api/v2/buyer/campaigns with type: "audience" - Target specific audience signals
  • Performance: POST /api/v2/buyer/campaigns with type: "performance" - Optimize for ROAS, conversions, leads, or sales
Campaign media buys:
  • GET /api/v2/buyer/campaigns/:campaignId/media-buys - List media buys
  • GET /api/v2/buyer/campaigns/:campaignId/media-buys/:id - Get media buy details
  • POST /api/v2/buyer/advertisers/:advertiserId/creative-sets - Create creative set
  • GET /api/v2/buyer/advertisers/:advertiserId/creative-sets/:id - Get creative set
  • GET /api/v2/buyer/advertisers/:advertiserId/creative-sets - List creative sets
  • PUT /api/v2/buyer/advertisers/:advertiserId/creative-sets/:id - Update creative set
  • DELETE /api/v2/buyer/advertisers/:advertiserId/creative-sets/:id - Delete creative set
  • POST /api/v2/buyer/advertisers/:advertiserId/creative-sets/:id/assets - Add asset
  • DELETE /api/v2/buyer/advertisers/:advertiserId/creative-sets/:id/assets/:assetId - Remove asset
  • GET /api/v2/buyer/advertisers/:advertiserId/reporting - Get reporting metrics
MCP-optimized workflow for AI agents to discover publisher ad products:
  • start_product_discovery - Start a discovery session
  • browse_publisher_products - Browse products from a publisher
  • refine_discovery_search - Apply filters to results
  • compare_discovery_publishers - Compare publishers side-by-side
  • update_discovery_session_products - Add/remove products from selection
  • get_discovery_recommendations - AI-powered product recommendations
  • get_discovery_plan_analysis - Analyze current selection
  • complete_discovery_session - Finalize the session
  • GET /api/v2/buyer/signals - List available audience signals for targeting

​
Architecture

  • API-First Design: REST API is the primary interface, MCP provides the same functionality for AI agents
  • OpenAPI Documentation: Auto-generated from TypeScript Zod schemas
  • Versioned Specs: All OpenAPI specs organized under mintlify/v1/ and mintlify/v2/