Developer documentation

Every request is authenticated with a secret key in the Authorization header, using the Bearer scheme.

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

If your API keys create advertiser accounts for your own users (Connect mode — see Authentication above), you earn a share of what those advertisers pay for their ads. The split below is read live from this same endpoint, never hardcoded, and is entirely separate from the referral commission further down this page.

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

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

How it works

1. One of your Connect-mode advertisers pays for an ad through your integration.
2. The ad is reviewed and approved — automatically, or by our moderation team.
3. Your share is queued for automatic payout to your wallet, same mechanism as the referral program below.

Payout conditions

• A crypto payout wallet is configured on your partner account.
• No KYC is required on your side — your partner account is already vetted at creation.

Example: reading accumulated shares

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
}

Every advertiser account gets a set of built-in AI tools — an ad content and visual generator, a conversational assistant, a budget advisor, and an external SEO auditor — paid for with AI credits, on top of the flat annual pricing.

Example — generate ad content

The same category and business description also power the image generator below.

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
}

Generate a matching visual for the same ad:

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
}

Drop a ready-made ad unit onto your own site — no build step, no iframe. The script renders directly into the page inside an isolated Shadow DOM, so its styles never leak into your site, and your site's styles never leak into it.

Add it to your page

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

By default this shows the full public ranking for the category — every advertiser on the platform, not just the ones you brought in. To show only the ads from advertisers you created through Connect mode (the ones generating your share), add data-partner with your partner ID (find it on the Developers page of your own 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>

If your advertisers span several categories, drop data-category entirely — with data-partner alone, the widget shows every one of your ads across all categories in one grid, instead of needing one widget block per category:

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

Want a footer-style unit alongside your in-content one, each showing different ads? Add a second widget block with data-layout="compact" (a single ad, collapsible into a small pill) and data-offset set to how many ads your first widget already shows:

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

Attributes

How a partner's referral commission actually reaches them — the percentage, the payout mechanism, and the preconditions.

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
}

Payout conditions

• The advertiser’s total payable earnings reach the minimum payout amount.
• A crypto payout wallet is configured on their account.
• Their KYC status is verified.

Example: reading accumulated earnings

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
}

Pricing tiers (live)

Read live from this endpoint — never hardcode these values, they can change on our side. Build a tier picker for your own users instead of a free amount field: each price shown is already the exact amount to send when creating the payment, and the unlocked benefits shown here tell users exactly what that price gets them, so they choose a price they understand instead of guessing a number.

Requests are capped per key, per minute. Every authenticated response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers; going over the limit returns 429 Too Many Requests with a Retry-After header.

Optional, per partner. Until you add an entry, your keys accept requests from any IP — the first entry switches all of that partner's keys to allowlist-only.

Every webhook is signed with HMAC-SHA256 using a secret issued once, at creation time — verify the signature before trusting the payload. Events are delivered only to the partner that owns the related advertiser.