Documentazione API

Integrati con la potente API di Laenad per automazione e soluzioni personalizzate

Introduzione

Benvenuto nella documentazione dell'API di Laenad. La nostra API REST ti consente di accedere programmaticamente ai tuoi dati di affiliazione, gestire le offerte e integrare soluzioni personalizzate nella tua piattaforma.

URL di base: https://api.laenad.com/v1

Tutte le risposte API vengono restituite in formato JSON. L'API utilizza codici di stato e verbi HTTP standard.

Autenticazione

Tutte le richieste API richiedono l'autenticazione tramite una chiave API. Includi la tua chiave API nell' Autorizzazione header:

Authorization: Bearer YOUR_API_KEY

Puoi generare le chiavi API dalla dashboard del tuo account. Ogni chiave ha permessi specifici e può essere revocata in qualsiasi momento.

POST /auth/generate-key

Genera una nuova chiave API per il tuo account

Limiti di frequenza

Per garantire un utilizzo corretto, l'API ha i seguenti limiti di frequenza:

  • Piano Standard: 1.000 richieste all'ora
  • Piano Premium: 5.000 richieste all'ora
  • Piano Enterprise: Richieste illimitate

Le intestazioni dei limiti di frequenza sono incluse in ogni risposta API:

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

Offerte

Recupera e filtra le offerte disponibili dalla piattaforma.

GET /offers

Ottieni tutte le offerte disponibili per il tuo account

Parametri

Parametro Tipo Obbligatorio Descrizione
page integer Facoltativo Numero di pagina per l'impaginazione (predefinito: 1)
limit integer Facoltativo Elementi per pagina (predefinito: 20, massimo: 100)
category string Facoltativo Filtra per categoria di offerta
country string Facoltativo Filtra per codice paese (ISO 3166-1 alpha-2)
Esempio di risposta:
{
  "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}

Ottieni informazioni dettagliate su una specifica offerta

Report

Accedi a dati di reportistica completi sulle tue prestazioni di affiliazione.

GET /reports/statistics

Ottieni un riepilogo delle statistiche per un intervallo di date

Parametri

Parametro Tipo Obbligatorio Descrizione
start_date string Obbligatorio Data di inizio (formato YYYY-MM-DD)
end_date string Obbligatorio Data di fine (formato YYYY-MM-DD)
offer_id integer Facoltativo Filtra per un ID offerta specifico
breakdown string Facoltativo Ripartizione per: giorno, offerta, paese, dispositivo
Esempio di risposta:
{
  "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
      }
    ]
  }
}

Conversioni

Recupera i dati delle conversioni con tutti i dettagli.

GET /conversions

Ottieni l'elenco delle conversioni con filtri

Parametri

Parametro Tipo Obbligatorio Descrizione
start_date string Obbligatorio Data di inizio (YYYY-MM-DD)
end_date string Obbligatorio Data di fine (YYYY-MM-DD)
status string Facoltativo Filtra per stato: in attesa, approvata, rifiutata
offer_id integer Facoltativo Filtra per ID offerta
Esempio di risposta:
{
  "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

Configura e gestisci gli URL postback per le notifiche delle conversioni in tempo reale.

POST /postbacks/create

Crea un nuovo URL postback

Corpo della richiesta

Parametro Tipo Obbligatorio Descrizione
url string Obbligatorio Endpoint del tuo URL postback
event_type string Obbligatorio Tipo di evento: conversione, clic, lead
offer_id integer Facoltativo Limita a un ID offerta specifico
secret string Facoltativo Chiave segreta per la convalida

Parametri postback disponibili

Il tuo URL postback può includere i seguenti parametri:

Parametro Descrizione
{conversion_id} Identificatore univoco della conversione
{offer_id} ID offerta
{payout} Importo del pagamento della conversione
{currency} Valuta del pagamento
{country} Codice paese dell'utente
{ip} Indirizzo IP dell'utente
{status} Stato della conversione
{datetime} Data e ora della conversione
{external_id} Il tuo ID transazione esterno

URL postback di esempio:

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

Aiuto e assistenza

Se hai bisogno di aiuto con l'integrazione dell'API o incontri problemi, il nostro team di assistenza è a tua disposizione.

Canali di assistenza

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

Risorse

SDK e librerie

Gli SDK ufficiali sono disponibili per i linguaggi di programmazione più diffusi:

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