Entwicklerdokumentation

Jede Anfrage wird mithilfe eines geheimen Schlüssels im „Authorization“-Header unter Verwendung des „Bearer“-Schemas authentifiziert.

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

Wenn Ihre API-Schlüssel Werbekundenkonten für Ihre eigenen Nutzer erstellen (Connect-Modus – siehe „Authentifizierung“ weiter oben), erhalten Sie einen Anteil an den Beträgen, die diese Werbekunden für ihre Anzeigen zahlen. Die unten aufgeführte Aufteilung wird live von diesem Endpunkt ausgelesen, ist niemals fest codiert und völlig unabhängig von der weiter unten auf dieser Seite beschriebenen Empfehlungsprovision.

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

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

So funktioniert es

1. Einer Ihrer Werbekunden im Connect-Modus bezahlt eine Anzeige über Ihre Integration.
2. Die Anzeige wird geprüft und freigegeben – entweder automatisch oder durch unser Moderationsteam.
3. Ihr Anteil wird für die automatische Auszahlung auf Ihr Wallet in die Warteschlange gestellt – nach dem gleichen Prinzip wie beim unten beschriebenen Empfehlungsprogramm.

Auszahlungsbedingungen

• In Ihrem Partnerkonto ist eine Wallet für Krypto-Auszahlungen eingerichtet.
• Von Ihrer Seite ist keine KYC-Prüfung erforderlich – Ihr Partnerkonto wurde bereits bei der Erstellung überprüft.

Beispiel: Auslesen der kumulierten Anteile

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
}

Jedes Werbekundenkonto verfügt über eine Reihe integrierter KI-Tools – einen Generator für Anzeigeninhalte und -grafiken, einen Chat-Assistenten, einen Budgetberater und ein externes SEO-Prüftool –, die zusätzlich zum pauschalen Jahrespreis mit KI-Guthaben bezahlt werden.

Beispiel – Anzeigeninhalt erstellen

Die gleiche Kategorie und Geschäftsbeschreibung dienen auch als Grundlage für den untenstehenden Bildgenerator.

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
}

Erstellen Sie eine passende Grafik für dieselbe Anzeige:

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
}

Fügen Sie eine vorgefertigte Anzeigeneinheit in Ihre eigene Website ein – ganz ohne Programmieraufwand und ohne Iframe. Das Skript wird direkt auf der Seite in einem isolierten Shadow-DOM gerendert, sodass dessen Stile niemals auf Ihre Website übergreifen und umgekehrt auch die Stile Ihrer Website niemals in das Skript übergreifen.

Füge es deiner Seite hinzu

<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äßig wird hier die vollständige öffentliche Rangliste für die Kategorie angezeigt – also alle Werbetreibenden auf der Plattform, nicht nur diejenigen, die Sie geworben haben. Um nur die Anzeigen der Werbetreibenden anzuzeigen, die Sie über den Connect-Modus gewonnen haben (d. h. diejenigen, die Ihren Anteil generieren), fügen Sie „data-partner“ mit Ihrer Partner-ID hinzu (diese finden Sie auf der Seite „Entwickler“ in Ihrem eigenen 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>

Wenn Ihre Werbekunden mehrere Kategorien abdecken, lassen Sie „data-category“ ganz weg – mit „data-partner“ allein zeigt das Widget alle Ihre Anzeigen aus allen Kategorien in einem Raster an, sodass Sie nicht für jede Kategorie einen eigenen Widget-Block benötigen:

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

Möchten Sie neben Ihrem Widget im Inhalt ein weiteres im Fußbereich platzieren, in dem jeweils andere Anzeigen angezeigt werden? Fügen Sie einen zweiten Widget-Block mit „data-layout=“compact““ (eine einzelne Anzeige, die sich zu einer kleinen Pille zusammenklappen lässt) hinzu und setzen Sie „data-offset“ auf die Anzahl der Anzeigen, die Ihr erstes Widget bereits anzeigt:

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

Attribute

Wie die Empfehlungsprovision eines Partners tatsächlich bei ihm ankommt – der Prozentsatz, die Auszahlungsmodalitäten und die Voraussetzungen.

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
}

Auszahlungsbedingungen

• Die insgesamt auszuzahlenden Einnahmen des Werbetreibenden erreichen den Mindestauszahlungsbetrag.
• In ihrem Konto ist eine Wallet für Krypto-Auszahlungen eingerichtet.
• Ihr KYC-Status ist verifiziert.

Beispiel: Ablesen der kumulierten Erträge

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
}

Preisstufen (live)

Lesen Sie die Werte live von diesem Endpunkt aus – geben Sie diese Werte niemals fest ein, da sie sich auf unserer Seite ändern können. Erstellen Sie für Ihre eigenen Nutzer eine Preisauswahl statt eines Feldes für einen frei wählbaren Betrag: Jeder angezeigte Preis entspricht bereits dem genauen Betrag, der bei der Erstellung der Zahlung zu überweisen ist, und die hier angezeigten freigeschalteten Vorteile erklären den Nutzern genau, was sie für diesen Preis erhalten, sodass sie einen Preis wählen, den sie verstehen, anstatt eine Zahl zu erraten.

Die Anzahl der Anfragen ist pro Schlüssel und Minute begrenzt. Jede authentifizierte Antwort enthält die Header „X-RateLimit-Limit“, „X-RateLimit-Remaining“ und „X-RateLimit-Reset“; bei Überschreitung des Limits wird der Status „429 Too Many Requests“ mit einem „Retry-After“-Header zurückgegeben.

Optional, pro Partner. Solange Sie keinen Eintrag hinzufügen, akzeptieren Ihre Schlüssel Anfragen von jeder beliebigen IP-Adresse – der erste Eintrag stellt alle Schlüssel dieses Partners so ein, dass nur noch Adressen aus der Whitelist zugelassen werden.

Jeder Webhook wird mit HMAC-SHA256 unter Verwendung eines einmaligen, bei der Erstellung generierten Geheimschlüssels signiert – überprüfen Sie die Signatur, bevor Sie der Nutzlast vertrauen. Ereignisse werden ausschließlich an den Partner übermittelt, dem der jeweilige Werbetreibende angehört.