Documentación para desarrolladores

Cada solicitud se autentica mediante una clave secreta incluida en el encabezado «Authorization», utilizando el esquema «Bearer».

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

Si tus claves API crean cuentas de anunciante para tus propios usuarios (modo «Connect»; véase «Autenticación» más arriba), obtendrás una parte de lo que esos anunciantes paguen por sus anuncios. El reparto que se indica a continuación se lee en tiempo real desde este mismo punto final, nunca está codificado de forma fija, y es totalmente independiente de la comisión por recomendación que aparece más abajo en esta página.

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

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

Cómo funciona

1. Uno de tus anunciantes del modo «Connect» paga por un anuncio a través de tu integración.
2. El anuncio se revisa y se aprueba, ya sea de forma automática o por nuestro equipo de moderación.
3. Tu participación está en cola para su pago automático a tu monedero, siguiendo el mismo mecanismo que el programa de recomendación que se describe a continuación.

Condiciones de pago

• Se ha configurado un monedero para pagos en criptomonedas en tu cuenta de socio.
• No es necesario que realices ningún proceso de KYC: tu cuenta de socio ya ha sido verificada en el momento de su creación.

Ejemplo: lectura de acciones 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 de anunciante dispone de un conjunto de herramientas de IA integradas —un generador de contenido y elementos visuales para anuncios, un asistente conversacional, un asesor de presupuesto y un auditor externo de SEO— que se pagan con créditos de IA, además de la tarifa plana anual.

Ejemplo: generar contenido publicitario

Esa misma categoría y descripción de la actividad también sirven de base para el generador de imágenes que aparece a continuación.

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
}

Genera un elemento visual a juego para el mismo 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
}

Inserta un bloque publicitario ya preparado en tu propia web: sin necesidad de programarlo ni de utilizar iframes. El script se muestra directamente en la página dentro de un Shadow DOM aislado, por lo que sus estilos nunca se filtran a tu web, y los estilos de tu web nunca se filtran al bloque publicitario.

Añádelo a tu página

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

De forma predeterminada, se muestra la clasificación pública completa de la categoría: todos los anunciantes de la plataforma, no solo los que tú has incorporado. Para mostrar únicamente los anuncios de los anunciantes que has creado a través del modo Connect (los que generan tu participación), añade «data-partner» junto con tu ID de socio (lo encontrarás en la página «Desarrolladores» de tu 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 tus anunciantes abarcan varias categorías, elimina por completo «data-category»: con solo «data-partner», el widget muestra todos tus anuncios de todas las categorías en una sola cuadrícula, en lugar de necesitar 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>

¿Quieres un bloque de estilo pie de página junto al que ya tienes en el contenido, de modo que cada uno muestre anuncios diferentes? Añade un segundo bloque de widgets con data-layout="compact" (un único anuncio, que se puede contraer en un pequeño recuadro) y data-offset establecido en el número de anuncios que ya muestra tu primer widget:

<!-- 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 se abona realmente a un colaborador la comisión por recomendación: el porcentaje, el mecanismo de pago y las condiciones previas.

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
}

Condiciones de pago

• Los ingresos totales a cobrar del anunciante alcanzan el importe mínimo de pago.
• Se ha configurado una cartera de pagos en criptomonedas en su cuenta.
• Se ha verificado su estado de KYC.

Ejemplo: consulta de los ingresos acumulados

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
}

Niveles de precios (activos)

Lee los datos en tiempo real desde este punto final; nunca introduzcas estos valores de forma fija, ya que pueden cambiar por nuestra parte. Crea un selector de planes para tus propios usuarios en lugar de un campo de importe libre: cada precio que se muestra es ya la cantidad exacta que hay que enviar al realizar el pago, y las ventajas desbloqueadas que se muestran aquí indican a los usuarios exactamente qué obtienen por ese precio, de modo que elijan un precio que entiendan en lugar de tener que adivinar una cifra.

Las solicitudes están limitadas por clave y por minuto. Cada respuesta autenticada incluye los encabezados X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset; si se supera el límite, se devuelve el código de error 429 «Too Many Requests» junto con el encabezado Retry-After.

Opcional, por socio. Hasta que añadas una entrada, tus claves aceptan solicitudes desde cualquier dirección IP; la primera entrada cambia todas las claves de ese socio para que solo acepten direcciones de la lista blanca.

Cada webhook se firma con HMAC-SHA256 utilizando un secreto que se genera una sola vez, en el momento de su creación; comprueba la firma antes de dar por válida la carga útil. Los eventos se envían únicamente al socio al que pertenece el anunciante correspondiente.