Ad Server | Full API Integration

Every feature and capacity we deliver can be used through our APIs

Ad Server is your complete API-first advertising solution, designed for businesses that need full control and customization. Every feature and capability Topsort offers is accessible through our comprehensive API suite, giving you maximum flexibility to build exactly what you need.

With Ad Server, you have complete control over auction logic, ranking algorithms, event tracking, and reporting. Perfect for companies with in-house development teams who want to deeply integrate advertising into their platform’s unique architecture and workflows.

Who Is This For?

Ad Server is ideal for:

• Enterprises with in-house engineering teams and custom requirements
• Technical teams needing full control over ad logic and ranking algorithms
• Businesses requiring deep integration with proprietary systems
• Platforms with unique auction mechanics or custom workflows

Want a faster setup? If you need quick deployment without extensive API integration, explore Ad Platform instead.

Key Benefits

Complete Flexibility

Full control over every aspect

Custom Logic

Build your own ranking algorithms

Deep Integration

Integrate with proprietary systems

Advanced Features

Access to all API capabilities

Core APIs

Build your advertising platform using three foundational APIs:

Catalog API

Keep your products, categories, and vendors synchronized with Topsort.

Products API

Manage product catalog data

Vendors API

Manage advertiser accounts

Categories API

Organize product taxonomy

Sync Strategies

Keep catalog data current

Auctions API

Trigger real-time bidding and retrieve winners for sponsored products and banners.

Auctions Overview

Real-time bidding mechanics

Promoted Products

Sponsored product listings

Promoted Banners

Banner ad auctions

Auction Responses

Handle auction results

Events API

Track impressions, clicks, and purchases to enable optimization, reporting, and attribution.

Events Overview

Event tracking fundamentals

Impressions

Track ad views

Clicks

Track ad interactions

Purchases

Track conversions and revenue

Getting Started

New to Ad Server? Follow these steps:

1. Set up your environment - Get API credentials and configure authentication
2. Sync your catalog - Use the Catalog API to import products, vendors, and categories
3. Implement auctions - Integrate auction calls into your search and browse flows
4. Track events - Send impression, click, and purchase events to close the loop
5. Test and optimize - Monitor performance and refine your implementation

Start with Authentication to get your API credentials, then move to Catalog API to sync your products.

Advanced Capabilities

Once you have the basics working, explore advanced features:

• Custom ranking algorithms - Implement your own logic for ad placement
• A/B testing - Run experiments on auction parameters and ranking strategies
• Custom attribution models - Build attribution logic that fits your business
• Real-time reporting - Create custom dashboards using our analytics endpoints
• Multi-region deployments - Scale across geographic regions

Want Quick Setup Instead?

While Ad Server provides maximum flexibility and control, some businesses prefer a faster path:

• Pre-built UI components instead of custom development
• Managed campaign tools instead of custom workflows
• Out-of-box reporting instead of custom dashboards
• Low-code integration instead of full API implementation

If this describes your needs, explore Ad Platform for pre-built tools and faster deployment.

Need help with your Topsort integration?

Talk to us, the integrations engineering team.

Reach us via your dedicated messaging channel or at [e-mail].

If you're not a customer yet, book a demo with our sales team instead.