API Documentation

Integrate with Laenad's powerful API for automation and custom solutions

Introduction

Welcome to the Laenad API documentation. Our REST API allows you to programmatically access your affiliate data, manage offers, and integrate custom solutions with your platform.

Base URL: https://api.laenad.com/v1

All API responses are returned in JSON format. The API uses standard HTTP status codes and verbs.

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

You can generate API keys from your account dashboard. Each key has specific permissions and can be revoked at any time.

POST /auth/generate-key

Generate a new API key for your account

Rate Limits

To ensure fair usage, the API has the following rate limits:

  • Standard Plan: 1,000 requests per hour
  • Premium Plan: 5,000 requests per hour
  • Enterprise Plan: Unlimited requests

Rate limit headers are included in every API response:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 995
X-RateLimit-Reset: 1640995200

Offers

Retrieve and filter available offers from the platform.

GET /offers

Get all available offers for your account

Parameters

Parameter Type Required Description
page integer Optional Page number for pagination (default: 1)
limit integer Optional Items per page (default: 20, max: 100)
category string Optional Filter by offer category
country string Optional Filter by country code (ISO 3166-1 alpha-2)
Response Example:
{
  "success": true,
  "data": [
    {
      "id": 12345,
      "name": "Premium VPN Offer",
      "category": "Software",
      "payout": 15.50,
      "currency": "USD",
      "countries": ["US", "CA", "GB", "AU"],
      "platform": "Android",
      "tracking_link": "https://track.laenad.com/?o=12345&a={affiliate_id}",
      "status": "active"
    }
  ],
  "pagination": {
    "total": 245,
    "page": 1,
    "pages": 13
  }
}
GET /offers/{id}

Get detailed information about a specific offer

Reports

Access comprehensive reporting data for your affiliate performance.

GET /reports/statistics

Get statistics summary for a date range

Parameters

Parameter Type Required Description
start_date string Required Start date (YYYY-MM-DD format)
end_date string Required End date (YYYY-MM-DD format)
offer_id integer Optional Filter by specific offer ID
breakdown string Optional Breakdown by: day, offer, country, device
Response Example:
{
  "success": true,
  "data": {
    "clicks": 15420,
    "conversions": 423,
    "revenue": 6565.50,
    "currency": "USD",
    "epc": 0.43,
    "conversion_rate": 2.74,
    "daily_breakdown": [
      {
        "date": "2026-03-27",
        "clicks": 2105,
        "conversions": 58,
        "revenue": 899.00
      }
    ]
  }
}

Conversions

Retrieve conversion data with full details.

GET /conversions

Get list of conversions with filters

Parameters

Parameter Type Required Description
start_date string Required Start date (YYYY-MM-DD)
end_date string Required End date (YYYY-MM-DD)
status string Optional Filter by status: pending, approved, rejected
offer_id integer Optional Filter by offer ID
Response Example:
{
  "success": true,
  "data": [
    {
      "id": 987654,
      "offer_id": 12345,
      "offer_name": "Premium VPN Offer",
      "conversion_time": "2026-03-27 14:32:15",
      "payout": 15.50,
      "currency": "USD",
      "status": "approved",
      "country": "US",
      "device": "mobile",
      "ip": "192.168.1.1"
    }
  ],
  "pagination": {
    "total": 423,
    "page": 1,
    "pages": 22
  }
}

Postbacks

Set up and manage postback URLs for real-time conversion notifications.

POST /postbacks/create

Create a new postback URL

Request Body

Parameter Type Required Description
url string Required Your postback URL endpoint
event_type string Required Event type: conversion, click, lead
offer_id integer Optional Limit to specific offer ID
secret string Optional Secret key for validation

Available Postback Parameters

Your postback URL can include the following parameters:

Parameter Description
{conversion_id} Unique conversion identifier
{offer_id} Offer ID
{payout} Conversion payout amount
{currency} Payout currency
{country} User's country code
{ip} User's IP address
{status} Conversion status
{datetime} Conversion timestamp
{external_id} Your external transaction ID

Example Postback URL:

https://yoursite.com/postback?
conversion_id={conversion_id}&
offer_id={offer_id}&
payout={payout}&
country={country}&
status={status}&
datetime={datetime}

Help & Support

If you need help integrating with the API or encounter any issues, our support team is here to assist you.

Support Channels

  • Email: api@laenad.com
  • QQ: 8422800
  • WeChat: laenad
  • Telegram: @laenadcom

Resources

SDKs & Libraries

Official SDKs are available for popular programming languages:

  • Python SDK
  • PHP SDK
  • JavaScript/Node.js SDK
  • Java SDK