Dokumentatioun fir Entwéckler

All Ufroen ginn mam Authorization-Header an engem geheime Schlëssel mam Bearer-Schema authentifizéiert.

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

Wann Är API-Schlësselen fir Är eege Benotzer Annonceur-Konten erstellen (Connect-Modus — kuckt hei uewen bei Authentifikatioun), verdéngt Dir e Undeel vun deem, wat dës Annonceuren fir hir Annoncen bezuelen. De Split hei ënnen gëtt direkt vun deemselwechte Endpunkt gelies, ni hart kodéiert, a steet komplett onofhängeg vun der Referral-Kommissioun, déi méi wäit ënnen op dëser Säit steet.

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

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

Wéi et funktionéiert

1. Ee vun äre Connect-Mode-Annonceuren bezilt fir eng Annonce iwwer Är Integratioun.
2. D'Annonce gëtt iwwerpréift an genehmegt — automatesch oder vun eisem Moderatiounsteam.
3. Äre Undeel steet an der Warteschlaang fir eng automatesch Ausbezuelung an Ärem Wallet, dee selwechte Mechanismus wéi am Referralprogramm hei ënnen.

Ausbezuelungsbedéngungen

• E Krypto-Ausbezuelungs-Wallet ass op Ärem Partnerkont konfiguréiert.
• Op ärer Säit ass keng KYC néideg — ären Partnerkont gouf schonn bei der Erstellunge iwwerpréift.

Beispill: geliesene akkumuléiert Aktien

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
}

All Annonceurkont kritt e Set vu agebaute KI-Tools — e Generator fir Annoncëinhalt a Visualen, e konversationellen Assistent, e Budgetberoder an en externen SEO-Auditor — déi mat KI-Kreditter bezuelt ginn, zousätzlech zum festen jäerlechen Präis.

Beispill — Annoncëinhalt generéieren

Déi selwecht Kategorie an d'Geschäftsbeschreiwung dréien och de Bildgenerator hei ënnen un.

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
}

Generéiert eng entspriechend Visual fir déi selwecht Annonce:

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
}

Setzt eng fäerdeg Annonce-Eenheet op Är eege Websäit — ouni Opbau-Schrëtt, ouni Iframe. D'Script renderéiert direkt an d'Säit bannent engem isoléierten Shadow DOM, sou datt seng Stiler ni op Är Websäit iwwergräifen, an d'Stiler vun Ärer Websäit ni doranner.

Füügt et op Är Säit derbäi.

<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>

Standardméisseg weist dëst d'vollstänneg ëffentlech Ranking vun der Kategorie — all Annonceur op der Plattform, net nëmmen déi, déi Dir iwwer Connect-Modus bruecht hutt. Fir nëmmen d'Annonce vun de Annonceuren ze weisen, déi Dir iwwer Connect-Modus erstallt hutt (déi Äre Undeel generéieren), füügt data-partner mat Ärer Partner-ID derbäi (fannt se op der Entwéckler-Säit vun Ärem eegene 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>

Wann Är Annonceuren iwwer verschidde Kategorien verdeelt sinn, looss d'Attribut data-category ganz ewech – mat nëmmen dem Attribut data-partner weist de Widget all Är Annoncen iwwer all Kategorien an engem eenzege Raster, amplaz datt Dir fir all Kategorie en eenzege Widget-Block braucht:

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

Wëllt Dir eng Footer-Stil-Eenheet nieft där an der Inhalts-Eenheet, déi all verschidde Annoncen weisen? Füügt e zweeten Widget-Block mat data-layout="compact" (eng eenzel Annonce, déi an eng kleng Pëll zesummegefaasst ka ginn) an mat data-offset op de Wäert gesat, wéi vill Annoncen Äre éischte Widget schonn weist:

<!-- 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>

Eegeschaften

Wéi eng Verweiskommissioun vun engem Partner hinnen eigentlech zougänglech gëtt — de Prozentsaz, de Bezuelungsmechanismus an d'Viraussetzungen.

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
}

Ausbezuelungsbedéngungen

• Déi total bezuelswäert Verdéngscht vum Annonceur erreechen de Mindestausbezuelungsbetrag.
• En Krypto-Ausbezuelungs-Wallet ass op hirem Kont konfiguréiert.
• Hiren KYC-Status ass verifizéiert.

Beispill: d'akkumuléiert Verdéngschter liesen

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
}

Präisniveauen (lieweg)

Lies live vun dësem Endpunkt — hardcodéier dës Wäerter ni, si kënnen op eiser Säit geännert ginn. Baut e Preissniveau-Auswieler fir Är eege Benotzer amplaz vun engem Feld fir e fräie Betrag: All ugewisenen Präis ass schonn de präzise Betrag, deen bei der Bezuelungserstellung verschéckt gëtt, an déi hei ugewisenen fräigeschalteten Virdeeler soen de Benotzer genee, wat dee Präis hinnen bitt, sou datt si e Präis auswielen, deen si verstoen, amplaz eng Zuel ze raten.

Ufroen si pro Schlëssel pro Minutt limitéiert. All authentifizéiert Äntwert enthält d'Header X-RateLimit-Limit, X-RateLimit-Remaining an X-RateLimit-Reset; wann de Limit iwwerschratt gëtt, gëtt de Status 429 Too Many Requests mat engem Retry-After-Header zréckginn.

Optional, pro Partner. Bis Dir en Eintrag derbäisetzt, akzeptéieren Är Schlësselen Ufroen vun all IP-Adress — den éischten Eintrag setzt all d'Schlësselen vun deem Partner op erlaabte Lëscht nëmmen.

All Webhook gëtt mat HMAC-SHA256 ënnerschriwwen, mat engem eemoleg erausginnten Geheimnis zur Zäit vun der Erstelle — iwwerpréift d'Ënnerschrëft ier Dir der Payload vertraut. Evenementer ginn nëmmen un de Partner geliwwert, deen dee jeeweilegen Annonceur besëtzt.