API 文档

集成 Laenad 强大的 API，实现自动化与定制方案

简介

欢迎使用 Laenad API 文档。我们的 REST API 允许您以编程方式访问联盟数据、管理 Offer，并与您的平台集成定制方案。

基础地址： https://api.laenad.com/v1

所有 API 响应均以 JSON 格式返回。API 使用标准的 HTTP 状态码和方法。

身份验证

所有 API 请求都需要使用 API 密钥进行身份验证。请在 Authorization 请求头中包含您的 API 密钥：

Authorization: Bearer YOUR_API_KEY

您可以在账户数据面板中生成 API 密钥。每个密钥具有特定权限，可随时撤销。

POST /auth/generate-key

为您的账户生成新的 API 密钥

频率限制

为确保公平使用，API 设有以下频率限制：

  • 标准版：每小时 1,000 次请求
  • 高级版：每小时 5,000 次请求
  • 企业版：不限请求数

每个 API 响应都包含频率限制响应头：

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

Offer

获取并筛选平台上可用的 Offer。

GET /offers

获取您账户的所有可用 Offer

Parameters

参数 类型 是否必填 说明
page integer 可选 分页页码（默认：1）
limit integer 可选 每页条数（默认：20，最大：100）
category string 可选 按 Offer 类别筛选
country string 可选 按国家代码筛选（ISO 3166-1 alpha-2）
响应示例：
{
  "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}

获取特定 Offer 的详细信息

报表

访问您的联盟业绩的综合报表数据。

GET /reports/statistics

获取指定日期范围的统计摘要

Parameters

参数 类型 是否必填 说明
start_date string 必填 开始日期（YYYY-MM-DD 格式）
end_date string 必填 结束日期（YYYY-MM-DD 格式）
offer_id integer 可选 按特定 Offer ID 筛选
breakdown string 可选 细分维度：按天、Offer、国家、设备
响应示例：
{
  "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
      }
    ]
  }
}

转化

获取包含完整详情的转化数据。

GET /conversions

获取带筛选条件的转化列表

Parameters

参数 类型 是否必填 说明
start_date string 必填 开始日期（YYYY-MM-DD）
end_date string 必填 结束日期（YYYY-MM-DD）
status string 可选 按状态筛选：待定、已批准、已拒绝
offer_id integer 可选 按 Offer ID 筛选
响应示例：
{
  "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
  }
}

Postback

设置和管理 Postback URL，实现实时转化通知。

POST /postbacks/create

创建新的 Postback URL

请求体

参数 类型 是否必填 说明
url string 必填 您的 Postback URL 端点
event_type string 必填 事件类型：转化、点击、线索
offer_id integer 可选 限定特定 Offer ID
secret string 可选 用于校验的密钥

可用的 Postback 参数

您的 Postback URL 可以包含以下参数：

参数 说明
{conversion_id} 唯一转化标识符
{offer_id} Offer ID
{payout} 转化佣金金额
{currency} 结算币种
{country} 用户所在国家代码
{ip} 用户 IP 地址
{status} 转化状态
{datetime} 转化时间戳
{external_id} 您的外部交易 ID

Postback URL 示例：

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

帮助与支持

如果您在集成 API 时需要帮助或遇到任何问题，我们的支持团队将竭诚为您服务。

支持渠道

  • 邮箱： api@laenad.com
  • QQ: 8422800
  • WeChat: laenad
  • Telegram: @laenadcom

相关资源

SDK 与开发库

我们为热门编程语言提供官方 SDK：

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