開発者向けドキュメント

すべてのリクエストは、Bearer方式を用いて、Authorizationヘッダー内のシークレットキーで認証されます。

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

APIキーを使用して自社のユーザー向けに広告主アカウントを作成する場合（Connectモード — 上記の「認証」を参照）、それらの広告主が広告に対して支払った金額の一部を受け取ることができます。以下の分配比率は、この同じエンドポイントからリアルタイムで読み込まれるものであり、ハードコードされたものではなく、このページの下部に記載されている紹介手数料とは完全に別物です。

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

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

仕組み

1. Connectモードの広告主のうちの1社が、貴社の連携機能を通じて広告費を支払います。
2. 広告は、自動的に、あるいは当社のモデレーションチームによって審査・承認されます。
3. お客様のシェアは、以下の紹介プログラムと同じ仕組みで、ウォレットへの自動支払い待ちの状態となっています。

支払い条件

• パートナーアカウントに、暗号資産の支払い用ウォレットが設定されています。
• お客様側でKYCの手続きを行う必要はありません。パートナーアカウントは作成時にすでに審査済みとなっています。

例：累積株式数の読み取り

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
}

すべての広告主アカウントには、定額制の年間料金に加えて、AIクレジットで利用できる一連の組み込みAIツール（広告コンテンツおよびビジュアル生成ツール、会話型アシスタント、予算アドバイザー、外部SEO監査ツール）が提供されます。

例 — 広告コンテンツの生成

以下の画像生成機能も、同じカテゴリーと事業概要に基づいて動作しています。

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
}

同じ広告に合わせて、適切なビジュアルを生成します：

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
}

既製の広告ユニットを自分のサイトにドラッグ＆ドロップするだけで、作成作業もiframeも不要です。スクリプトは、隔離されたShadow DOM内でページに直接レンダリングされるため、そのスタイルがサイトに漏れることはなく、またサイトのスタイルが広告ユニットに漏れることもありません。

ページに追加する

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

デフォルトでは、このカテゴリの公開ランキング全体が表示されます。つまり、あなたが紹介したものだけでなく、プラットフォーム上のすべての広告主が含まれます。「Connectモード」を通じて作成した広告主（あなたのシェアを生み出している広告主）の広告のみを表示するには、パートナーID（ご自身のダッシュボードの「開発者」ページで確認できます）を指定して「data-partner」を追加してください：

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

広告主が複数のカテゴリーにまたがっている場合は、「data-category」を完全に削除してください。これにより、「data-partner」のみを設定することで、ウィジェットはすべてのカテゴリーにわたる広告を1つのグリッドにまとめて表示するようになり、カテゴリーごとに個別のウィジェットブロックを用意する必要がなくなります：

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

コンテンツ内のウィジェットとは別に、フッター形式のウィジェットを追加して、それぞれ異なる広告を表示させたいですか？その場合は、data-layout="compact"（広告1つ、小さなピル型に折りたためる）を指定し、data-offsetを最初のウィジェットがすでに表示している広告の数に合わせて設定した2つ目のウィジェットブロックを追加してください：

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

属性

パートナーへの紹介手数料が実際にどのように支払われるのか――その割合、支払いの仕組み、および前提条件について。

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
}

支払い条件

• 広告主の支払対象となる収益総額が、最低支払額に達しました。
• そのアカウントには、暗号資産の支払い用ウォレットが設定されています。
• KYCのステータスは確認済みです。

例：累積利益の読み取り

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
}

料金プラン（提供中）

このエンドポイントからリアルタイムで読み取ってください。これらの値をハードコーディングしないでください。当社側で変更される可能性があります。 「無料枠」の入力欄の代わりに、ユーザー向けのプラン選択画面を作成してください。表示されている各価格は、支払いを作成する際に送信すべき正確な金額そのものであり、ここに表示されている特典内容から、その価格で購入できるものがユーザーに明確に伝わるため、ユーザーは推測で金額を決めるのではなく、内容を理解した上で価格を選択できます。

リクエストには、キーごと、1分あたりの上限が設定されています。認証済みのレスポンスにはすべて、X-RateLimit-Limit、X-RateLimit-Remaining、およびX-RateLimit-Resetヘッダーが含まれます。上限を超えた場合は、Retry-Afterヘッダーを含む429 Too Many Requestsが返されます。

オプション（パートナーごとに設定可能）。エントリを追加するまでは、そのキーはどのIPからのリクエストも受け付けますが、最初のエントリを追加すると、そのパートナーのすべてのキーが許可リストのみの受け入れに切り替わります。

すべてのウェブフックは、作成時に一度だけ発行されるシークレットを使用して HMAC-SHA256 で署名されています。ペイロードを信頼する前に、署名を検証してください。イベントは、関連する広告主を所有するパートナーにのみ配信されます。