Documentatie voor ontwikkelaars

Elk verzoek wordt geverifieerd met een geheime sleutel in de Authorization-header, waarbij gebruik wordt gemaakt van het Bearer-schema.

POST https://api.adhub365.com/v1/partner/ads
Authorization: Bearer sk_sandbox_...
Content-Type: application/json

Als je API-sleutels adverteerdersaccounts aanmaken voor je eigen gebruikers (Connect-modus — zie ‘Authenticatie’ hierboven), verdien je een deel van wat die adverteerders voor hun advertenties betalen. De onderstaande verdeling wordt in realtime opgehaald via ditzelfde eindpunt, is nooit vastgelegd in de code en staat volledig los van de verwijzingscommissie die verderop op deze pagina wordt beschreven.

GET https://api.adhub365.com/v1/partner-program

{
  "partner_share_percentage": 0.7,
  "platform_share_percentage": 0.3
}

Hoe het werkt

1. Een van je adverteerders in de Connect-modus betaalt voor een advertentie via jouw integratie.
2. De advertentie wordt gecontroleerd en goedgekeurd — automatisch of door ons moderatieteam.
3. Je aandeel staat in de wachtrij voor automatische uitbetaling naar je portemonnee; dit werkt op dezelfde manier als het onderstaande aanbevelingsprogramma.

Uitbetalingsvoorwaarden

• Er is een crypto-uitbetalingsportemonnee geconfigureerd op uw partneraccount.
• U hoeft zelf geen KYC-procedure te doorlopen — uw partneraccount is al bij het aanmaken gecontroleerd.

Voorbeeld: het aantal opgebouwde aandelen opvragen

GET https://api.adhub365.com/v1/partner/ad-revenue/earnings
Authorization: Bearer sk_sandbox_...

{
  "shares": [
    {
      "id": "share_1a2b...",
      "payment_id": "pay_9f2a...",
      "ad_id": "ad_7c31...",
      "partner_amount_usd": 140.0,
      "platform_amount_usd": 60.0,
      "status": "paid",
      "payable_after": "2026-08-03T00:00:00Z",
      "paid_at": "2026-08-05T10:12:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 140.0
}

Elk adverteerdersaccount krijgt een reeks ingebouwde AI-tools — een generator voor advertentie-inhoud en -afbeeldingen, een conversatie-assistent, een budgetadviseur en een externe SEO-auditor — die worden betaald met AI-credits, bovenop het vaste jaarlijkse tarief.

Voorbeeld — advertentie-inhoud genereren

Dezelfde categorie en bedrijfsbeschrijving vormen ook de basis voor de onderstaande afbeeldingsgenerator.

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "title": "Handmade Oak Dining Tables — Built to Last",
  "description": "Solid oak dining tables crafted by hand, built to last a lifetime.",
  "keywords": ["oak furniture", "dining table", "handmade"],
  "credits_remaining": 8
}

Maak een bijpassende afbeelding voor dezelfde advertentie:

POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio/image
Authorization: Bearer <session access token>
Content-Type: application/json

{
  "category_name": "Furniture",
  "business_description": "We sell handmade oak dining tables"
}

{
  "visual_url": "https://cdn.uploadscenter.com/file_01m1...",
  "credits_remaining": 4
}

Plaats een kant-en-klare advertentieblok op je eigen site — zonder dat je iets hoeft te bouwen en zonder iframe. Het script wordt rechtstreeks in de pagina weergegeven binnen een geïsoleerde Shadow DOM, zodat de stijlen ervan nooit in je site terechtkomen en de stijlen van je site nooit in het advertentieblok terechtkomen.

Voeg het toe aan je pagina

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Standaard wordt hier de volledige openbare ranglijst voor de categorie weergegeven — alle adverteerders op het platform, niet alleen degenen die je hebt aangetrokken. Om alleen de advertenties weer te geven van adverteerders die je via de Connect-modus hebt aangemaakt (die waarvoor je een aandeel ontvangt), voeg je ‘data-partner’ toe met je partner-ID (te vinden op de pagina ‘Ontwikkelaars’ van je eigen dashboard):

<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Als je adverteerders in meerdere categorieën actief zijn, laat dan ‘data-category’ helemaal weg — met alleen ‘data-partner’ toont de widget al je advertenties uit alle categorieën in één raster, in plaats van dat je voor elke categorie een apart widgetblok nodig hebt:

<div
  class="annualads-widget"
  data-geo="global"
  data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Wil je naast je widget in de inhoud nog een widget in de voettekst plaatsen, waarbij elke widget andere advertenties toont? Voeg dan een tweede widgetblok toe met data-layout="compact" (één advertentie, die kan worden ingeklapt tot een klein bolletje) en stel data-offset in op het aantal advertenties dat je eerste widget al toont:

<!-- in your content -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-count="4"
  data-columns="2"
></div>

<!-- in your footer, showing different ads via data-offset -->
<div
  class="annualads-widget"
  data-category="YOUR_CATEGORY_ID"
  data-geo="global"
  data-layout="compact"
  data-offset="4"
></div>
<script async src="https://adhub365.com/widget.js"></script>

Kenmerken

Hoe de doorverwijzingsprovisie van een partner daadwerkelijk bij hem terechtkomt — het percentage, de uitbetalingswijze en de voorwaarden.

GET https://api.adhub365.com/v1/referral-program

{
  "levels": [
    {
      "level": 1,
      "percentage": 0.1
    }
  ],
  "leaders_pool_percentage_of_gmv": 0.05,
  "founding_advertiser_pool_percentage_of_gmv": 0.05,
  "payout_verification_window_hours": 48,
  "min_payout_usd": 1
}

Uitbetalingsvoorwaarden

• De totale uit te betalen inkomsten van de adverteerder hebben het minimale uitbetalingsbedrag bereikt.
• Er is een crypto-uitbetalingsportemonnee geconfigureerd op hun account.
• Hun KYC-status is geverifieerd.

Voorbeeld: het aflezen van de opgebouwde winst

GET https://api.adhub365.com/v1/partner/referrals/{code}/earnings
Authorization: Bearer sk_sandbox_...

{
  "code": "ann-2f8c",
  "earnings": [
    {
      "id": "earn_1a2b...",
      "payment_id": "pay_9f2a...",
      "amount_usd": 30.0,
      "status": "paid",
      "payable_after": "2026-08-01T00:00:00Z",
      "paid_at": "2026-08-03T14:22:00Z"
    }
  ],
  "total_payable_pending_usd": 0.0,
  "total_payable_usd": 0.0,
  "total_processing_usd": 0.0,
  "total_paid_usd": 30.0
}

Prijsniveaus (live)

Lees de gegevens live vanaf dit eindpunt — codeer deze waarden nooit vast, want ze kunnen aan onze kant veranderen. Maak voor je eigen gebruikers een keuzehulp voor tariefniveaus in plaats van een veld voor een vrij in te vullen bedrag: elke getoonde prijs is al het exacte bedrag dat bij het aanmaken van de betaling moet worden overgemaakt, en de hier getoonde voordelen laten gebruikers precies zien wat ze voor die prijs krijgen, zodat ze een prijs kiezen die ze begrijpen in plaats van een bedrag te moeten raden.

Het aantal verzoeken is per sleutel en per minuut beperkt. Elk geauthenticeerd antwoord bevat de headers X-RateLimit-Limit, X-RateLimit-Remaining en X-RateLimit-Reset; als de limiet wordt overschreden, wordt de statuscode 429 Too Many Requests geretourneerd, samen met een Retry-After-header.

Optioneel, per partner. Zolang je geen vermelding toevoegt, accepteren je sleutels verzoeken van elk willekeurig IP-adres — de eerste vermelding zorgt ervoor dat alle sleutels van die partner voortaan alleen nog maar verzoeken van de toegestane lijst toelaten.

Elke webhook wordt ondertekend met HMAC-SHA256 met behulp van een eenmalig gegenereerd geheim dat bij het aanmaken wordt toegekend — controleer de handtekening voordat je de payload vertrouwt. Gebeurtenissen worden uitsluitend verzonden naar de partner die eigenaar is van de betreffende adverteerder.