Skip to main content
July 16, 2025ToppieNew Feature
Why It’s ImportantAPI keys enable secure, programmatic access to Toppie’s unified retail media platform. Whether you’re automating campaign management, building custom dashboards, or integrating Toppie data into your existing workflows, API keys provide the foundation for scaling your retail media operations beyond the UI.

​
What’s New

We’re rolling out API keys for Toppie, our demand-side platform that streamlines retail media buying across multiple retailers. All Toppie API endpoints will now require secure, token-based authentication.

​
Key Benefits

Automate Campaign Operations: Build workflows that create, manage, and optimize campaigns across multiple retailers without manual intervention. Custom Integrations: Connect Toppie data to your BI tools, reporting dashboards, or internal systems for unified retail media analytics. Secure Access Control: Role-based permissions ensure team members only access the data and capabilities they need.

​
How to Create API Keys

  1. Navigate to Settings in your Toppie dashboard
  2. Select API Integration from the left-hand navigation
  3. Click the ”+ New API Key” button
  4. Important: Copy and save your API key immediately—it will only be displayed once for security
  5. Store your API key in a secure location (password manager, secrets management system, etc.)
Toppie API Integration interface showing the New API Key button

​
Using Your API Keys

Once you have your API key, you can start making requests to the Toppie API. Include your key in the request headers for authentication.

​
Example Request

curl -X GET https://api.topsort.com/toppie/v1/campaigns \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

​
Available Endpoints

Explore the full capabilities of the Toppie API:
  • Product Catalog Access
  • Campaign Lifecycle Management
  • Advanced Analytics and Reporting
Visit our Toppie API Reference for complete documentation.

​
Questions?

Contact your Toppie account manager for assistance with API integration or to discuss advanced use cases for programmatic campaign management.