Documentacion del desvolopaire

Cada requèsta es autenticada amb una clau secreta dins l'entèsta d'autorizacion, en utilizant l'esquema Bearer.

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

Se vòstras claus API crean de comptes d'anunciants per vòstres pròpris utilizaires (mòde Connect — veire l'autentificacion mai naut), ganhatz una partida de çò que aqueles anunciants pagan per lors anóncias. La reparticion çai jos se legís en dirècte dempuèi aquel meteis punt de fin, jamai codificada en dur, e es completament separada de la comission de referéncia mai avall sus aquesta pagina.

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

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

Cossí fonciona

1. Un dels vòstres anunciants en mòde Connect paga una anóncia a travèrs de vòstra integracion.
2. La publicitat es revisada e aprovada — automaticament, o per nòstra equipa de moderacion.
3. Ta part es mesa dins la fila d'espèra per un pagament automatic dins ton portamoneda, lo meteis mecanisme que lo programa de referéncia çai jos.

Condicions de pagament

• Un portamoneda de pagament en criptomoneda es configurat sus vòstre compte de partenari.
• Cap de KYC es pas necessari de vòstre costat — vòstre compte de partenari es ja verificat al moment de sa creacion.

Exemple: lectura de las accions acumuladas

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
}

Cada compte de publicitari obtén un ensems d'aisinas d'IA integradas — un generator de contengut e d'imatges publicitàrias, un assistent de conversacion, un conselhièr de pressupòst e un auditor SEO extern — pagadas amb crèdits d'IA, en mai del prètz annual fix.

Exemple — generar de contengut publicitari

La meteissa categoria e la descripcion de l'entrepresa alimentan tanben lo generator d'imatges çai jos.

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
}

Generatz un visual adaptat per la meteissa anóncia:

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
}

Deposatz una unitat publicitària prèsta sus vòstre site — sens cap de pas de construccion, sens iframe. Lo script se rendís dirèctament dins la pagina dins un Shadow DOM isolat, atal sos estils jamai se filtran dins vòstre site, e los estils de vòstre site jamai se filtran dins el.

Apondètz aquò a vòstra pagina

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

Per defaut, aquò mòstra lo classament public complet de la categoria — cada anunciant sus la plataforma, pas solament aqueles que avètz integrats. Per mostrar solament los anóncis dels anunciants que avètz creats a travèrs del mòde Connect (aqueles que generisson vòstra part), apondètz data-partner amb vòstre ID de partenari (lo trobaretz sus la pagina dels desvolopaires de vòstre tablèu de bord):

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

Se vòstres anunciants s'estenden a mantunas categorias, suprimissètz completament data-category — amb solament data-partner, lo widget aficha totes vòstres anóncias dins totas las categorias dins una sola grilha, en luòc d'aver besonh d'un blòc de widget per cada categoria:

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

Volètz una unitat en estil de piè de pagina al costat de la vòstra unitat dins lo contengut, caduna mostrant d'anóncias diferentas? Apondètz un segond blòc de widget amb data-layout="compact" (una anóncia unica, plegabla dins una pichòta pílula) e data-offset ajustat al nombre d'anóncias que vòstre primièr widget ja mòstra:

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

Atributs

Cossí la comission de referiment d'un partenari arriba realament a el — lo percentatge, lo mecanisme de pagament e las precondicionas.

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
}

Condicions de pagament

• Los guanhs totals pagables de l'anunciant aténon lo montant minim de pagament.
• Un portamoneda de pagament en criptomoneda es configurat sus lor compte.
• Lor estatut KYC es verificat.

Exemple: legir los guanhs acumulats

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
}

Nivèls de prètz (en dirècte)

Legissètz en dirècte dempuèi aqueste punt de fin — jamai codar en dur aquelas valors, pòdon cambiar de nòstre costat. Construïtz un selector de nivèls per vòstres utilizaires en luòc d'un camp de montada liura : cada prètz afichat es ja la soma exacta de mandar al moment de crear lo pagament, e los avantatges desblocats afichats aquí dison exactament çò que aquel prètz lor balha, atal causisson un prètz que comprenon en luòc d'endevinar un nombre.

Las demandas son limitadas per clau e per minuta. Cada responsa autenticada pòrta los en-tèstas X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset ; se se despassa lo limit, se retorna lo còde d'error 429 Too Many Requests amb l'en-tèsta Retry-After.

Opcional, per cada partenari. Fins que n'ajustatz pas una entrada, las vòstras claus accèptan las demandas de quina adreça IP que siá — la primièra entrada met totas las claus d'aquel partenari en mòde de lista blanca solament.

Cada webhook es signat amb HMAC-SHA256 en utilizant un secret emés un sol còp al moment de la creacion — verificatz la signatura abans de far fisança al contengut. Los eveniments son livrats solament al partenari que possedís l'anunciant concernit.