Introduction

This is the public API documentation for FirstPromoter V2.

Welcome to the FirstPromoter API! This documentation will guide you through the process of integrating with our platform programmatically, allowing you to leverage the full power of FirstPromoter’s affiliate and referral tracking capabilities in your own applications.

Why Use Our API?

Automation: Streamline your workflow by automating repetitive tasks
Integration: Seamlessly incorporate FirstPromoter’s capabilities into your existing systems Customization: Build custom solutions tailored to your specific business needs

Who Should Use This API?

Due to the technical nature of API integrations, this documentation is designed for developers and any other technical individual who want to:

• Integrate FirstPromoter with their existing tools and platforms
• Create custom dashboards or reporting systems
• Automate affiliate management processes
• Build specialized applications leveraging FirstPromoter’s functionality

Getting Started

To begin using the FirstPromoter API, you’ll need:

1. A FirstPromoter account
2. Your account id and an API key
3. Basic knowledge of REST API principles

Rate Limits

To ensure fair usage and system stability, FirstPromoter implements the following rate limits:

• 400 requests per minute per account

Exceeding these limits will result in a 429 Too Many Requests response.

Pagination

When retrieving multiple affiliates, the API uses pagination to limit the number of records returned in a single response. This ensures optimal performance for both the API and your application.

Pagination Parameters

Parameter	Type	Description
page	Integer	The page number to retrieve (default: 1)
per_page	Integer	Number of records per page (default: 25 for most endpoints, with no enforced maximum)

Pagination defaults can vary by endpoint. The campaigns list endpoint is a notable exception: it defaults to 10 per page and caps at a maximum of 50. Check each endpoint’s own documentation if you need its exact behavior.