# Referral API for Modern Products

Add an affiliate program to your product in minutes, embedded right inside your app with no revenue limits.

## Developer Quickstart

Get up and running in three steps.

### 1. Install the tracking script

HTML

```
<script src="https://scripts.refgrowcdn.com/latest.js"
  data-project-id="YOUR_PROJECT_ID"></script>
```

### 2. Track signups

JavaScript

```javascript
// Call after user signs up
Refgrow(0, 'signup', 'user@example.com');
```

### 3. Track purchases

JavaScript

```javascript
// Call after successful payment
Refgrow(49.99, 'purchase', 'user@example.com');
```

## Key Endpoints

GET `/api/v1/affiliates`

List all affiliates for your project with stats, referral codes, and earnings.

POST `/api/v1/conversions`

Record a conversion event (signup or purchase) server-side.

GET `/api/v1/conversions`

Retrieve conversion history with filters by date, affiliate, and type.

GET `/api/v1/stats`

Get aggregate stats: clicks, signups, revenue, and active affiliates.

POST `/api/v1/payouts`

Initiate payouts to affiliates via PayPal or Wise.

## Auth, Errors & Limits

- Authenticate with Bearer token using your API key (prefix: rgk\_)
- API keys are hashed and stored securely
- Rate limits: 100 requests per minute per project
- All responses use standard HTTP status codes
- Errors return JSON with descriptive messages

HTTP

```
Authorization: Bearer rgk_your_api_key_here
Content-Type: application/json
```

## Key Features

Everything you need to run a successful affiliate program.

### Easy Integration

Embed an affiliate program into your product in minutes with a simple code snippet.

### Flexible Tracking

Track via Stripe/LS webhooks or manually via JS. Customize cookies and parameters.

### Deep Customization

Customize the design (colors, text, layout) to match your brand perfectly.

### Advanced Commissions

Set default rules (%, fixed, duration) and override per-affiliate or per-product.

### Global Ready

Multi-language support for the embedded dashboard (EN, RO, UA, DE, ES, FR, IT, PT+).

### Developer API

Integrate programmatically with our REST API for full control.

## Try Refgrow free today

Set up your affiliate program in minutes and start growing with referrals.