Dokumentasi pamekar

Unggal pamundut dioténtikasi ku konci rusiah dina header Otorisasi, ngagunakeun skéma Bearer.

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

Lamun konci API anjeun nyieun akun pangiklan pikeun pamaké anjeun sorangan (mode Connect — tingali Autentikasi di luhur), anjeun meunang bagian tina naon anu dibayar ku para pangiklan éta pikeun iklan maranéhna. Bagi hasil di handap dibaca sacara langsung tina endpoint anu sarua, teu kungsi di-hardcode, sarta sacara lengkep misah tina komisi rujukan anu aya di handap kaca ieu.

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

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

Kumaha jalanna

1. Salah sahiji pangiklan dina mode Connect mayar iklan ngaliwatan integrasi anjeun.
2. Iklan éta ditinjau jeung disatujuan — sacara otomatis, atawa ku tim moderasi kami.
3. Bagian anjeun geus diasupkeun kana antrian pikeun pamayaran otomatis ka dompét anjeun, maké mékanisme anu sarua jeung program rujukan di handap.

Syarat pamayaran

• Dompet pamayaran kripto geus diatur dina akun mitra anjeun.
• Teu diperlukeun KYC di pihak anjeun — akun pasangan anjeun geus diverifikasi nalika dijieun.

Conto: maca saham anu geus numpuk

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
}

Unggal akun pangiklan meunang sakumpulan pakakas AI bawaan — generator eusi iklan jeung visual, asistén paguneman, penaséhat anggaran, jeung auditor SEO éksternal — anu mayarna maké kredit AI, salian ti harga taunan anu tetep.

Conto — ngahasilkeun eusi iklan

Kategori anu sarua jeung katerangan bisnis ogé ngajalankeun generator gambar di handap.

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
}

Jieun visual nu cocog pikeun iklan anu sarua:

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
}

Pasang unit iklan siap-paké kana situs anjeun — teu aya léngkah ngawangun, teu aya iframe. Skripna nampilkeun langsung kana kaca dina Shadow DOM nu misah, jadi gaya na moal bocor kana situs anjeun, sarta gaya situs anjeun ogé moal bocor kana éta.

Tambahkeun kana kaca anjeun

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

Bawana ieu nembongkeun peringkat umum lengkep pikeun kategori — sakabéh pangiklan dina platform, henteu ngan ukur anu anjeun bawa. Pikeun nembongkeun ngan iklan ti pangiklan anu anjeun jieun ngaliwatan mode Connect (anu ngahasilkeun bagian anjeun), tambahkeun data-partner kalayan ID mitra anjeun (manggihan éta dina kaca Pamekar dina dasbor anjeun sorangan):

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

Lamun pangiklan anjeun nyebar dina sababaraha kategori, hapus data-category sakabéhna — ku ngan ukur maké data-partner, widget bakal némbongkeun sakabéh iklan anjeun di sakabéh kategori dina hiji grid, tinimbang kudu hiji blok widget pikeun tiap kategori:

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

Hayang unit gaya footer gigireun unit dina eusi anjeun, duanana némbongkeun iklan anu béda? Tambahkeun blok widget kadua kalayan data-layout="compact" (hiji iklan, bisa dilipet jadi pil leutik) jeung data-offset disetél sabaraha iklan anu geus ditingalikeun ku widget munggaran anjeun:

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

Sipat-sipat

Kumaha komisi rujukan ti mitra sabenerna nepi ka maranéhna — perséntaséna, mékanisme pamayaran, jeung sarat-sarat saméméhna.

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
}

Sarat pamayaran

• Jumlah total panghasilan anu kudu dibayar ku pangiklan geus ngahontal jumlah pamayaran minimum.
• Dompet pamayaran kripto geus diatur dina akunna.
• Status KYC maranéhna geus diverifikasi.

Conto: maca panghasilan anu geus numpuk

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
}

Tingkat harga (hirup)

Baca sacara langsung tina endpoint ieu — ulah kungsi hardcode nilai-nilai ieu, sabab éta tiasa robah di sisi kami. Bangun picker tingkatan pikeun pamaké anjeun sorangan tinimbang widang jumlah gratis: unggal harga anu dipidangkeun geus jumlah pasti anu kudu dikirim nalika nyieun pamayaran, sarta kauntungan anu kabuka anu dipidangkeun di dieu ngabejaan ka pamaké persis naon anu maranéhna meunang tina harga éta, sangkan maranéhna milih harga anu maranéhna ngartos tinimbang nebak angka.

Pamundut diwatesan per konci, per menit. Unggal réspon anu geus dioténtikasi ngandung header X-RateLimit-Limit, X-RateLimit-Remaining, jeung X-RateLimit-Reset; lamun ngaleuwihan watesan bakal ngabalikeun kode kasalahan 429 Too Many Requests kalayan header Retry-After.

Opsional, per pasangan. Nepi ka anjeun nambahkeun éntri, konci anjeun nampi pamundut ti sagala IP — éntri kahiji ngalihkeun sakabéh konci pasangan éta jadi ngan ukur dina daptar ijin.

Unggal webhook ditandatanganan ku HMAC-SHA256 maké rusiah anu dikaluarkeun sakali nalika waktos nyiptakeun — pariksa tanda tangan saméméh percaya kana muatan. Kajadian ngan dikirimkeun ka mitra anu miboga pangiklan anu patali.