API-Dokumentation

Integrieren Sie die leistungsstarke Laenad-API für Automatisierung und individuelle Lösungen

Einleitung

Willkommen in der Laenad-API-Dokumentation. Unsere REST-API ermöglicht Ihnen den programmatischen Zugriff auf Ihre Affiliate-Daten, die Verwaltung von Offers und die Integration individueller Lösungen in Ihre Plattform.

Basis-URL: https://api.laenad.com/v1

Alle API-Antworten werden im JSON-Format zurückgegeben. Die API verwendet standardmäßige HTTP-Statuscodes und -Methoden.

Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung mit einem API-Schlüssel. Fügen Sie Ihren API-Schlüssel in den Authorization Header ein:

Authorization: Bearer YOUR_API_KEY

Sie können API-Schlüssel in Ihrem Account-Dashboard generieren. Jeder Schlüssel hat spezifische Berechtigungen und kann jederzeit widerrufen werden.

POST /auth/generate-key

Neuen API-Schlüssel für Ihren Account generieren

Ratenbegrenzungen

Um eine faire Nutzung sicherzustellen, gilt für die API folgende Ratenbegrenzung:

  • Standard-Tarif: 1.000 Anfragen pro Stunde
  • Premium-Tarif: 5.000 Anfragen pro Stunde
  • Enterprise-Tarif: Unbegrenzte Anfragen

Ratenbegrenzungs-Header sind in jeder API-Antwort enthalten:

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

Offers

Rufen Sie verfügbare Offers von der Plattform ab und filtern Sie sie.

GET /offers

Alle verfügbaren Offers für Ihren Account abrufen

Parameter

Parameter Typ Erforderlich Beschreibung
page integer Optional Seitennummer für Paginierung (Standard: 1)
limit integer Optional Einträge pro Seite (Standard: 20, Max.: 100)
category string Optional Nach Offer-Kategorie filtern
country string Optional Nach Ländercode filtern (ISO 3166-1 alpha-2)
Antwortbeispiel:
{
  "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}

Detaillierte Informationen zu einem bestimmten Offer abrufen

Berichte

Greifen Sie auf umfassende Berichtsdaten zu Ihrer Affiliate-Leistung zu.

GET /reports/statistics

Statistikübersicht für einen Zeitraum abrufen

Parameter

Parameter Typ Erforderlich Beschreibung
start_date string Erforderlich Startdatum (Format JJJJ-MM-TT)
end_date string Erforderlich Enddatum (Format JJJJ-MM-TT)
offer_id integer Optional Nach bestimmter Offer-ID filtern
breakdown string Optional Aufschlüsselung nach: Tag, Offer, Land, Gerät
Antwortbeispiel:
{
  "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

Rufen Sie Conversion-Daten mit allen Details ab.

GET /conversions

Liste der Conversions mit Filtern abrufen

Parameter

Parameter Typ Erforderlich Beschreibung
start_date string Erforderlich Start date (YYYY-MM-DD)
end_date string Erforderlich End date (YYYY-MM-DD)
status string Optional Nach Status filtern: ausstehend, genehmigt, abgelehnt
offer_id integer Optional Filter by offer ID
Antwortbeispiel:
{
  "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

Richten Sie Postback-URLs für Echtzeit-Conversion-Benachrichtigungen ein und verwalten Sie sie.

POST /postbacks/create

Neue Postback-URL erstellen

Anfragekörper

Parameter Typ Erforderlich Beschreibung
url string Erforderlich Ihr Postback-URL-Endpunkt
event_type string Erforderlich Ereignistyp: Conversion, Klick, Lead
offer_id integer Optional Auf bestimmte Offer-ID beschränken
secret string Optional Geheimschlüssel zur Validierung

Verfügbare Postback-Parameter

Ihre Postback-URL kann die folgenden Parameter enthalten:

Parameter Beschreibung
{conversion_id} Eindeutiger Conversion-Bezeichner
{offer_id} Offer ID
{payout} Auszahlungsbetrag der Conversion
{currency} Auszahlungswährung
{country} Ländercode des Benutzers
{ip} IP-Adresse des Benutzers
{status} Conversion-Status
{datetime} Conversion-Zeitstempel
{external_id} Ihre externe Transaktions-ID

Beispiel-Postback-URL:

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

Hilfe & Support

Wenn Sie Hilfe bei der API-Integration benötigen oder auf Probleme stoßen, steht Ihnen unser Support-Team zur Verfügung.

Support-Kanäle

  • E-Mail: api@laenad.com
  • QQ: 8422800
  • WeChat: laenad
  • Telegram: @laenadcom

Ressourcen

SDKs & Bibliotheken

Offizielle SDKs sind für gängige Programmiersprachen verfügbar:

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