Documentación d'o desembolicador

Cada solicitut s'autentica con una clau secreta en o encabezau d'Autorización, fendo servir l'esquema Bearer.

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

Si as tuyas claus d'API creyan cuentas d'anunciants pa os tuyos propios usuarios (modo Connect — se veiga Autenticación más entalto), ganas una parte de lo que ixos anunciants pagan por os suyos anuncios. A división de más t'abaixo se leye en directo dende iste mesmo punto final, nunca codificada en duro, y ye de tot deseparada d'a comisión de derivación más abaixo en ista pachina.

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

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

Cómo funciona

1. Un d'os tuyos anunciants en modo Connect paga un anuncio a traviés d'a tuya integración.
2. L'anuncio se revisa y s'apreba — automaticament, u por o nuestro equipo de moderación.
3. A tuya parte ye en a cola pa o pago automatico a la tuya cartera, o mesmo mecanismo que o programa de referenzia de debaixo.

Condicions de pago

• S'ha configurau una cartera de pago en criptomoneda en a tuya cuenta de socio.
• No cal KYC por a tuya parte — a tuya cuenta de socio ya ha estau verificada en creyar-la.

Exemplo: leyer as 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 cuenta d'anunciant tiene un conchunto de ferramientas d'IA integradas —un chenerador de conteniu y visuals publicitarios, un asistent de conversa, un consellero de presupuesto y un auditor SEO externo— pagadas con creditos d'IA, amás d'o preu anyal fixo.

Exemplo — chenerar conteniu publicitario

A mesma categoría y descripción d'o negocio tamién alimentan o chenerador d'imachens de debaixo.

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
}

Chenerar una imachen a chuego pa o mesmo anuncio:

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
}

Fica una unidat publicitaria prefabricada en o tuyo propio puesto web — sin necesidat de construcción, sin iframe. O script dibuja-se directament en a pachina adintro d'un Shadow DOM isolau, de traza que os suyos estilos nunca no s'escapan enta o tuyo puesto web, y os estilos d'o tuyo puesto web nunca no s'escapan enta él.

Adhibe-lo a la tuya pachina

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

Por defecto, isto amuestra o ranking publico completo d'a categoría — toz os anunciants d'a plataforma, no nomás os que has trayiu. Pa amostrar nomás os anuncios d'os anunciants que has creyau a traviés d'o modo Connect (os que cheneran a tuya parte), adhibe data-partner con o tuyo ID de socio (lo trobarás en a pachina de Desembolicadors d'o tuyo propio panel de control):

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

Si os suyos anunciants s'estienden por cuantas categorías, quite de tot "data-category" — con "data-partner" solo, o widget amuestra toz os suyos anuncios de todas as categorías en una sola ret, en cuenta de precisar un bloque de widget por categoría:

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

Quiers una unidat en estilo pie de pachina chunto a la tuya de dentro d'o conteniu, amostrando cada una anuncios diferents? Adhibe un segundo bloque de widgets con data-layout="compact" (un solo anuncio, plegable en una pastilla chicota) y data-offset configurau a o numero d'anuncios que o tuyo primer widget ya amuestra:

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

Atributos

Cómo una comisión de derivación d'un socio realment le plega — o porcentache, o mecanismo de pago y as precondicions.

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 pago

• Os ingresos totals pagaders de l'anunciant plegan a la cantidat minima de pago.
• S'ha configurau una cartera de pago en criptomoneda en a suya cuenta.
• O suyo estau KYC ye verificau.

Exemplo: leyer os beneficios acumulaus

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
}

Nivels de pre (en directo)

Leye en directo dende iste punto de fin — nunca no codifiques istos valors de traza fixa, pueden cambiar d'a nuestra parte. Crea un selector de nivels pa os tuyos propios usuarios en cuenta d'un campo de cantidat libre: cada pre amostrau ye ya a cantidat exacta que cal ninviar en creyar o pago, y os beneficios desbloquiaus que s'amuestran aquí le dicen a os usuarios exactament qué les ofreixe ixe pre, pa que esliyan un pre que entiendan en cuenta d'endevinar un numero.

As solicituz son limitadas por clau, por minuto. Cada respuesta autenticada transporta as cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset; superar o limite retorna 429 Too Many Requests con una cabecera Retry-After.

Opcional, por socio. Dica que adhibas una dentrada, as tuyas claus acceptan solicituz dende cualsiquier IP — a primera dentrada cambia todas as claus d'ixe socio ta que nomás accepten d'a lista blanca.

Cada webhook ye sinyau con HMAC-SHA256 fendo servir un secreto emitiu nomás que una vegada, en o momento d'a suya creyación — comprebe a sinyatura antes de confiar en a carga útil. Os eventos se entregan nomás que a o socio que ye o propietario de l'anunciant relacionau.