API-documentatie

Integreer met de krachtige API van Laenad voor automatisering en maatwerkoplossingen

Introductie

Welkom bij de API-documentatie van Laenad. Met onze REST API kun je programmatisch toegang krijgen tot je affiliate data, aanbiedingen beheren en maatwerkoplossingen integreren met je platform.

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

Alle API-responsen worden geretourneerd in JSON-formaat. De API gebruikt standaard HTTP-statuscodes en -werkwoorden.

Authenticatie

Alle API-verzoeken vereisen authenticatie met een API-sleutel. Neem je API-sleutel op in de Authorization-header:

Authorization: Bearer YOUR_API_KEY

Je kunt API-sleutels genereren vanuit je accountdashboard. Elke sleutel heeft specifieke rechten en kan op elk moment worden ingetrokken.

POST /auth/generate-key

Genereer een nieuwe API-sleutel voor je account

Rate Limits

Om eerlijk gebruik te waarborgen, hanteert de API de volgende rate limits:

  • Standaard Abonnement: 1.000 verzoeken per uur
  • Premium Abonnement: 5.000 verzoeken per uur
  • Enterprise Abonnement: Onbeperkt verzoeken

Rate limit-headers zijn opgenomen in elke API-respons:

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

Aanbiedingen

Haal beschikbare aanbiedingen op en filter ze op het platform.

GET /offers

Krijg alle beschikbare aanbiedingen voor je account

Parameters

Parameter Type Vereist Beschrijving
page integer Optioneel Paginanummer voor paginering (standaard: 1)
limit integer Optioneel Items per pagina (standaard: 20, max: 100)
category string Optioneel Filter op aanbiedingscategorie
country string Optioneel Filter op landcode (ISO 3166-1 alpha-2)
Responsvoorbeeld:
{
  "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}

Krijg gedetailleerde informatie over een specifieke aanbieding

Rapporten

Krijg toegang tot uitgebreide rapportagedata over je affiliate prestaties.

GET /reports/statistics

Krijg een statistieksamenvatting voor een datumbereik

Parameters

Parameter Type Vereist Beschrijving
start_date string Vereist Startdatum (YYYY-MM-DD formaat)
end_date string Vereist Einddatum (YYYY-MM-DD formaat)
offer_id integer Optioneel Filter op specifieke aanbiedings-ID
breakdown string Optioneel Uitsplitsing per: dag, aanbieding, land, apparaat
Responsvoorbeeld:
{
  "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
      }
    ]
  }
}

Conversies

Haal conversiedata op met volledige details.

GET /conversions

Krijg een lijst met conversies met filters

Parameters

Parameter Type Vereist Beschrijving
start_date string Vereist Startdatum (YYYY-MM-DD)
end_date string Vereist Einddatum (YYYY-MM-DD)
status string Optioneel Filter op status: in behandeling, goedgekeurd, afgewezen
offer_id integer Optioneel Filter op aanbiedings-ID
Responsvoorbeeld:
{
  "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

Stel postback-URL's in en beheer ze voor realtime conversiemeldingen.

POST /postbacks/create

Maak een nieuwe postback-URL aan

Verzoekbody

Parameter Type Vereist Beschrijving
url string Vereist Je postback-URL endpoint
event_type string Vereist Eventtype: conversie, klik, lead
offer_id integer Optioneel Beperk tot specifieke aanbiedings-ID
secret string Optioneel Geheime sleutel voor validatie

Beschikbare Postback-Parameters

Je postback-URL kan de volgende parameters bevatten:

Parameter Beschrijving
{conversion_id} Unieke conversie-identificator
{offer_id} Aanbiedings-ID
{payout} Uitbetalingbedrag van conversie
{currency} Uitbetalingsvaluta
{country} Landcode van de gebruiker
{ip} IP-adres van de gebruiker
{status} Conversiestatus
{datetime} Conversietijdstempel
{external_id} Je externe transactie-ID

Voorbeeld Postback-URL:

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

Hulp & Ondersteuning

Als je hulp nodig hebt bij de integratie met de API of problemen ondervindt, staat ons supportteam voor je klaar.

Ondersteuningskanalen

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

Bronnen

SDK's & Libraries

Officiële SDK's zijn beschikbaar voor populaire programmeertalen:

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