Documentación de la API

Intégrate con la potente API de Laenad para automatización y soluciones personalizadas

Introducción

Bienvenido a la documentación de la API de Laenad. Nuestra API REST te permite acceder programáticamente a tus datos de afiliado, gestionar ofertas e integrar soluciones personalizadas con tu plataforma.

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

Todas las respuestas de la API se devuelven en formato JSON. La API utiliza códigos y verbos HTTP estándar.

Autenticación

Todas las solicitudes a la API requieren autenticación mediante una clave de API. Incluye tu clave de API en el encabezado Authorization:

Authorization: Bearer YOUR_API_KEY

Puedes generar claves de API desde el panel de tu cuenta. Cada clave tiene permisos específicos y puede revocarse en cualquier momento.

POST /auth/generate-key

Genera una nueva clave de API para tu cuenta

Límites de Tasa

Para garantizar un uso justo, la API tiene los siguientes límites de tasa:

  • Plan Estándar: 1,000 solicitudes por hora
  • Plan Premium: 5,000 solicitudes por hora
  • Plan Enterprise: Solicitudes ilimitadas

Los encabezados de límite de tasa se incluyen en cada respuesta de la API:

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

Ofertas

Obtén y filtra las ofertas disponibles de la plataforma.

GET /offers

Obtén todas las ofertas disponibles para tu cuenta

Parámetros

Parámetro Tipo Obligatorio Descripción
page integer Opcional Número de página para la paginación (predeterminado: 1)
limit integer Opcional Elementos por página (predeterminado: 20, máximo: 100)
category string Opcional Filtrar por categoría de oferta
country string Opcional Filtrar por código de país (ISO 3166-1 alpha-2)
Ejemplo de Respuesta:
{
  "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}

Obtén información detallada sobre una oferta específica

Informes

Accede a datos completos de informes sobre tu rendimiento como afiliado.

GET /reports/statistics

Obtén un resumen de estadísticas para un rango de fechas

Parámetros

Parámetro Tipo Obligatorio Descripción
start_date string Obligatorio Fecha de inicio (formato YYYY-MM-DD)
end_date string Obligatorio Fecha de fin (formato YYYY-MM-DD)
offer_id integer Opcional Filtrar por ID de oferta específica
breakdown string Opcional Desglose por: día, oferta, país, dispositivo
Ejemplo de Respuesta:
{
  "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
      }
    ]
  }
}

Conversiones

Obtén datos de conversiones con todos los detalles.

GET /conversions

Obtén la lista de conversiones con filtros

Parámetros

Parámetro Tipo Obligatorio Descripción
start_date string Obligatorio Fecha de inicio (YYYY-MM-DD)
end_date string Obligatorio Fecha de fin (YYYY-MM-DD)
status string Opcional Filtrar por estado: pendiente, aprobada, rechazada
offer_id integer Opcional Filtrar por ID de oferta
Ejemplo de Respuesta:
{
  "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

Configura y gestiona URLs de postback para notificaciones de conversiones en tiempo real.

POST /postbacks/create

Crea una nueva URL de postback

Cuerpo de la Solicitud

Parámetro Tipo Obligatorio Descripción
url string Obligatorio Tu endpoint de URL de postback
event_type string Obligatorio Tipo de evento: conversión, clic, lead
offer_id integer Opcional Limitar a un ID de oferta específico
secret string Opcional Clave secreta para validación

Parámetros de Postback Disponibles

Tu URL de postback puede incluir los siguientes parámetros:

Parámetro Descripción
{conversion_id} Identificador único de conversión
{offer_id} ID de la oferta
{payout} Monto de pago de la conversión
{currency} Moneda del pago
{country} Código de país del usuario
{ip} Dirección IP del usuario
{status} Estado de la conversión
{datetime} Marca de tiempo de la conversión
{external_id} Tu ID de transacción externo

URL de Postback de Ejemplo:

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

Ayuda y Soporte

Si necesitas ayuda para integrarte con la API o tienes algún problema, nuestro equipo de soporte está aquí para asistirte.

Canales de Soporte

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

Recursos

SDKs y Librerías

Hay SDKs oficiales disponibles para los lenguajes de programación más populares:

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