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 develpers 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

ParameterTypeDescription
pageIntegerThe page number to retrieve (default: 1)
per_pageIntegerNumber of records per page (default: 20, max: 100)