Dokumentasyon ng developer

Ang bawat kahilingan ay pinapatotohanan gamit ang isang lihim na susi sa Authorization header, gamit ang Bearer na iskema.

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

Kung ang iyong mga API key ay lumilikha ng mga advertiser account para sa iyong sariling mga user (Connect mode — tingnan ang Authentication sa itaas), makakakuha ka ng bahagi ng babayaran ng mga advertiser na iyon para sa kanilang mga ad. Ang split sa ibaba ay nababasa nang live mula sa parehong endpoint na ito, hindi kailanman naka-hardcode, at ganap na hiwalay sa referral commission na makikita pa sa ibaba ng pahinang ito.

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

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

Paano ito gumagana

1. Isa sa iyong mga advertiser sa Connect mode ang nagbabayad para sa isang ad sa pamamagitan ng iyong integrasyon.
2. Sinusuri at inaprubahan ang patalastas — awtomatiko, o ng aming koponang nagmo-moderate.
3. Ang bahagi mo ay naka-pila para sa awtomatikong pagbabayad sa iyong pitaka, parehong mekanismo tulad ng referral program sa ibaba.

Mga kundisyon ng bayad

• Isang crypto payout wallet ang naka-configure sa iyong partner account.
• Hindi kailangan ng KYC sa iyong bahagi — ang iyong partner account ay na-verify na nang likhain ito.

Halimbawa: pagbabasa ng naipong mga bahagi

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
}

Bawat account ng advertiser ay may kasamang hanay ng built-in na AI tools — isang tagabuo ng nilalaman at visual para sa ad, isang conversational assistant, isang tagapayo sa badyet, at isang panlabas na SEO auditor — na binabayaran gamit ang AI credits, bukod pa sa nakapirming taunang presyo.

Halimbawa — gumawa ng nilalaman ng patalastas

Ang parehong kategorya at paglalarawan ng negosyo ay nagpapatakbo rin sa tagabuo ng larawan sa ibaba.

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
}

Gumawa ng katugmang visual para sa parehong patalastas:

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
}

I-drop ang isang handang-gamitin na ad unit sa iyong sariling site — walang hakbang sa pagbuo, walang iframe. Ang script ay direktang nagre-render sa pahina sa loob ng isang hiwalay na Shadow DOM, kaya hindi kailanman nakakalusot ang mga estilo nito sa iyong site, at hindi rin nakakalusot ang mga estilo ng iyong site dito.

Idagdag ito sa iyong pahina

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

Sa default, ipinapakita nito ang buong pampublikong ranggo para sa kategorya — bawat advertiser sa platform, hindi lang yung mga dinala mo. Para ipakita lamang ang mga ad mula sa mga advertiser na nilikha mo sa pamamagitan ng Connect mode (yung mga nagbibigay ng iyong bahagi), idagdag ang data-partner kasama ang iyong partner ID (hanapin ito sa Developers page ng iyong sariling 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>

Kung ang iyong mga advertiser ay sumasaklaw sa ilang kategorya, alisin nang buo ang data-category — gamit lamang ang data-partner, ipapakita ng widget ang bawat isa sa iyong mga ad sa lahat ng kategorya sa isang grid, sa halip na kailanganin ng isang widget block para sa bawat kategorya:

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

Gusto mo bang magkaroon ng yunit na naka-footer sa tabi ng yunit sa loob ng nilalaman, na bawat isa ay nagpapakita ng iba't ibang ad? Magdagdag ng pangalawang widget block na may data-layout="compact" (isang ad na maaaring i-collapse sa maliit na pill) at itakda ang data-offset ayon sa kung ilang ad na ang ipinapakita ng unang widget mo:

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

Mga Katangian

Paano talaga nakakarating sa isang partner ang komisyon mula sa referral — ang porsyento, ang mekanismo ng pagbabayad, at ang mga paunang kundisyon.

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
}

Mga kundisyon ng bayad

• Umabot na sa pinakamababang halagang babayaran ang kabuuang kikitain ng nag-aanunsyo.
• May naka-configure na crypto payout wallet sa kanilang account.
• Napatunayan na ang kanilang KYC status.

Halimbawa: pagbabasa ng naipong kita

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
}

Mga antas ng presyo (live)

Magbasa nang live mula sa endpoint na ito — huwag kailanman i-hardcode ang mga halagang ito, maaari silang magbago sa aming panig. Gumawa ng tagapili ng antas para sa iyong mga gumagamit sa halip na patlang para sa libreng halaga: ang bawat presyong ipinapakita ay eksaktong halagang ipapadala kapag gumagawa ng bayad, at ang mga benepisyong nakalock na ipinapakita rito ay nagsasabi sa mga gumagamit kung ano ang makukuha nila sa presyong iyon, kaya pinipili nila ang presyong nauunawaan nila sa halip na hulaan ang isang numero.

Limitado ang mga kahilingan kada susi, kada minuto. Bawat na-authenticate na tugon ay may kasamang mga header na X-RateLimit-Limit, X-RateLimit-Remaining, at X-RateLimit-Reset; kapag nalampasan ang limitasyon, magbabalik ito ng 429 Too Many Requests na may Retry-After header.

Opsyonal, bawat kasosyo. Hanggang hindi ka pa nagdaragdag ng entry, tinatanggap ng iyong mga susi ang mga kahilingan mula sa anumang IP — ang unang entry ay magpapalipat sa lahat ng susi ng kasosyong iyon sa allowlist-only.

Bawat webhook ay nilagdaan gamit ang HMAC-SHA256 sa pamamagitan ng isang lihim na inilabas nang isang beses sa oras ng paglikha — suriin ang lagda bago magtiwala sa payload. Ang mga kaganapan ay ipinapadala lamang sa kasosyong nagmamay-ari ng kaugnay na advertiser.