Partners API Documentation

Welcome to the Markopolo Partners API documentation. The Partners API enables platforms to integrate MarkTag tracking capabilities into their own systems, allowing them to offer advanced analytics and conversion tracking to their users.

Who Is This For?

The Partners API is designed for platforms that want to integrate MarkTag as an analytics solution:

E-commerce Platforms

Integrate MarkTag tracking directly into your platform, enabling merchants to set up analytics without leaving your dashboard

E-commerce Platforms

Integrate MarkTag tracking directly into your platform, enabling merchants to set up analytics without leaving your dashboard

E-commerce Platforms

Integrate MarkTag tracking directly into your platform, enabling merchants to set up analytics without leaving your dashboard

Website Builders

Offer MarkTag as a built-in analytics solution for websites created on your platform

Website Builders

Offer MarkTag as a built-in analytics solution for websites created on your platform

Website Builders

Offer MarkTag as a built-in analytics solution for websites created on your platform

Marketing Platforms

Add MarkTag tracking capabilities to enhance your marketing automation or analytics features

Marketing Platforms

Add MarkTag tracking capabilities to enhance your marketing automation or analytics features

Marketing Platforms

Add MarkTag tracking capabilities to enhance your marketing automation or analytics features

Key Features

Merchant Management

Create and manage merchant accounts under your partner umbrella
Organize multiple merchants from a single API integration
Isolate merchant data for security and privacy

MarkTag Generation & Verification

Generate unique tracking implementations for each merchant domain
Automatic detection of preverified vs regular domains
DNS configuration validation to ensure proper setup
Support for multiple tags per merchant

Event Data Access

Retrieve tracking events collected by MarkTag
Filter by date ranges, event types, and other parameters
Access conversion data and user interactions
Real-time event streaming capabilities

Quick Start

#1 Get API Access & Complete Onboarding

Contact partners@markopolo.ai
Our team will learn about your business and use cases
You'll receive:
- Your Partners API token (mp_live_*)
- A CNAME record to add to your domain
Configure the CNAME on your domain to enable preverified marktags

Why the CNAME setup?

Enables instant marktag generation under your domain
No DNS verification delays for your merchants
Immediate event tracking once tags are created

#2 Authentication

Use Bearer token authentication with your API token:

curl -H "Authorization: Bearer mp_live_YOUR_TOKEN" \
  https://api-alpha.markopolo.ai/v1/partners/merchant

#3 Make Your First Call

Test your connection:

curl -X GET https://api-alpha.markopolo.ai/v1/partners/merchant?limit=1 \
  -H "Authorization: Bearer mp_live_YOUR_TOKEN"

API Overview

Base URL

https://api-alpha.markopolo.ai/v1/partners

Request/Response Format

Format: JSON
Authentication: Bearer token (mp_live_ prefix)
Method: RESTful API endpoints

Integration Workflow

For Preverified Domains (Your Platform)

Create Merchant - Register merchants under your partner account
Generate MarkTag - Create tracking using your preverified domain
Start Tracking - Immediately begin collecting events (no DNS wait)
Retrieve Data - Access event data through the API

For Custom Merchant Domains

Create Merchant - Register merchants under your partner account
Generate MarkTag - Create tracking for merchant's custom domain
Configure DNS - Merchant adds CNAME record to their domain
Verify Installation - Use verification API to confirm DNS setup
Collect Events - MarkTag begins tracking user interactions
Retrieve Data - Access event data through the API

Support & Resources

Email: partners@markopolo.ai
Documentation: Complete API reference and guides
Integration Support: Technical assistance for implementation

Not What You're Looking For?

If you need to implement tracking on websites or mobile apps to capture user events and analytics,
check out our MarkTag SDK Documentation instead.