Dokumentation för utvecklare

Varje förfrågan autentiseras med en hemlig nyckel i Authorization-rubriken, med hjälp av Bearer-metoden.

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

Om dina API-nycklar skapar annonsörskonton åt dina egna användare (Connect-läge – se ”Autentisering” ovan) får du en andel av det som dessa annonsörer betalar för sina annonser. Fördelningen nedan hämtas i realtid från samma slutpunkt, är aldrig fastkodad och är helt skild från den hänvisningsprovision som beskrivs längre ner på denna sida.

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

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

Så här fungerar det

1. En av dina annonsörer i Connect-läget betalar för en annons via din integration.
2. Annonsen granskas och godkänns – antingen automatiskt eller av vårt modereringsteam.
3. Din andel står i kö för automatisk utbetalning till din plånbok, enligt samma princip som i rekommendationsprogrammet nedan.

Utbetalningsvillkor

• En plånbok för utbetalningar i kryptovaluta är konfigurerad på ditt partnerkonto.
• Du behöver inte genomföra någon KYC-process – ditt partnerkonto har redan granskats när det skapades.

Exempel: avläsning av ackumulerade andelar

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
}

Varje annonsörskonto får tillgång till en uppsättning inbyggda AI-verktyg – en generator för annonsinnehåll och bilder, en konversationsassistent, en budgetrådgivare och en extern SEO-granskare – som betalas med AI-krediter utöver den fasta årsavgiften.

Exempel – skapa annonsinnehåll

Samma kategori och verksamhetsbeskrivning ligger även till grund för bildgeneratorn nedan.

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
}

Skapa en passande bild till samma annons:

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
}

Lägg in en färdig annonsenhet på din egen webbplats – utan att behöva bygga något själv och utan iframe. Skriptet renderas direkt på sidan inuti ett isolerat Shadow DOM, vilket innebär att dess stilar aldrig påverkar din webbplats och att din webbplats stilar aldrig påverkar det.

Lägg till det på din sida

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

Som standard visas här den fullständiga offentliga rankningen för kategorin – alla annonsörer på plattformen, inte bara de som du har värvat. För att endast visa annonser från annonsörer som du har skapat via Connect-läget (de som genererar din andel) lägger du till data-partner tillsammans med ditt partner-ID (du hittar det på sidan ”Utvecklare” i din egen kontrollpanel):

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

Om dina annonsörer spänner över flera kategorier ska du ta bort ”data-category” helt och hållet – med endast ”data-partner” visar widgeten alla dina annonser från alla kategorier i ett enda rutnät, istället för att du behöver ett widgetblock per kategori:

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

Vill du ha en enhet i fotnoten bredvid den som finns i själva innehållet, där var och en visar olika annonser? Lägg till ett andra widgetblock med data-layout="compact" (en enda annons, som kan fällas ihop till en liten ruta) och data-offset inställt på det antal annonser som din första widget redan visar:

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

Egenskaper

Hur en partners rekommendationsprovision faktiskt betalas ut till denne – procentandelen, utbetalningsmekanismen och villkoren.

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
}

Utbetalningsvillkor

• Annonsörens totala utbetalningsbara intäkter uppnår minimibeloppet för utbetalning.
• En plånbok för utbetalningar i kryptovaluta har konfigurerats på deras konto.
• Deras KYC-status har verifierats.

Exempel: avläsning av ackumulerade intäkter

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
}

Prisnivåer (live)

Läs värdena direkt från denna slutpunkt – ange aldrig dessa värden direkt i koden, eftersom de kan ändras från vår sida. Skapa en prisväljare för dina egna användare istället för ett fält för fritt val av belopp: varje pris som visas är redan det exakta beloppet som ska skickas när betalningen skapas, och de upplåsta förmånerna som visas här talar om för användarna exakt vad de får för det priset, så att de väljer ett pris de förstår istället för att gissa ett belopp.

Antalet förfrågningar är begränsat per nyckel och per minut. Varje autentiserat svar innehåller rubrikerna X-RateLimit-Limit, X-RateLimit-Remaining och X-RateLimit-Reset. Om gränsen överskrids returneras felkoden 429 Too Many Requests tillsammans med rubriken Retry-After.

Valfritt, per partner. Tills du lägger till en post godkänner dina nycklar förfrågningar från vilken IP-adress som helst – den första posten gör att alla den partnerns nycklar endast godkänner anslutningar från adresser på tillåtelselistan.

Varje webhook signeras med HMAC-SHA256 med hjälp av en hemlig nyckel som genereras en gång vid skapandet – kontrollera signaturen innan du litar på datamängden. Händelser levereras endast till den partner som äger den berörda annonsören.