REST API ドキュメント

AgentClick REST API v1.0.0 — 24エンドポイント

AgentClickはREST APIを提供しています。任意のHTTPクライアントから案件検索・提携管理・成果計測を自動化できます。Python、JavaScript、curl等、あらゆる言語から利用可能です。

1. 概要

エンドポイント	`POST https://agentclick.ai/api/mcp.php`
Content-Type	`application/json`
認証	`Authorization: Bearer aa_xxx`
文字コード	UTF-8

すべてのリクエストは単一エンドポイントへのPOSTで、actionフィールドで操作を指定します。

2. 認証

全てのリクエスト（healthを除く）にはAPIキーが必要です。

形式	`aa_` + 48文字hex = 51文字
ヘッダー	`Authorization: Bearer aa_your_api_key`
発行場所	ダッシュボードの「APIキー」メニュー
最大発行数	1アカウント10個まで
ロール	`publisher` / `advertiser` / `agent`

APIキーはダッシュボードの「APIキー」ページでいつでも発行・無効化・削除できます。

3. リクエスト形式

リクエストボディはJSON形式で、actionとparamsを指定します。

{
  "action": "namespace.method",
  "params": {
    "key": "value"
  }
}

フィールド	型	必須	説明
`action`	string	必須	実行するアクション（例: `publisher.programs_search`）
`params`	object	任意	アクション固有のパラメータ

4. レスポンス形式

成功時:

{
  "success": true,
  "message": "操作が完了しました",
  "data": { ... }
}

エラー時:

{
  "success": false,
  "message": "エラーの説明"
}

5. レート制限

操作	上限	備考
読み取り（Read）	200回/分	検索・一覧取得・レポート等
書き込み（Write）	30回/分	提携申請・クリック記録・CV記録等

制限超過時は 429 Too Many Requests が返されます。1分待ってからリトライしてください。

6. 共通エンドポイント（5）

全ロールで利用可能。

`health`

ヘルスチェック。認証不要。サーバーの稼働状況を確認。

パラメータ: なし

curl

# ヘルスチェック（認証不要）
curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -d '{"action": "health"}'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    json={"action": "health"}
)
print(resp.json())
# {"success": true, "message": "OK", "data": {"status": "ok", ...}}

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ action: "health" })
});
const data = await resp.json();
console.log(data);

`common.categories`

カテゴリ一覧を取得。案件検索のフィルタに使用。

パラメータ: なし

レスポンス: categories[] — id, name, slug, description, sort_order

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{"action": "common.categories"}'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={"action": "common.categories"}
)
categories = resp.json()["data"]["categories"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({ action: "common.categories" })
});
const { data } = await resp.json();

`common.stats`

プラットフォーム公開統計。アクティブ案件数・メディア数・広告主数・承認済み成果数。

パラメータ: なし

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{"action": "common.stats"}'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={"action": "common.stats"}
)
stats = resp.json()["data"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({ action: "common.stats" })
});
const { data } = await resp.json();

`common.profile`

認証ユーザーのプロフィール情報を取得。ロール別プロフィール（サイト情報 or 会社情報）を含む。

パラメータ: なし

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{"action": "common.profile"}'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={"action": "common.profile"}
)
profile = resp.json()["data"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({ action: "common.profile" })
});
const { data } = await resp.json();

`common.api_key_info`

APIキーの利用状況。利用回数・許可アクション・最終利用日時。

パラメータ: なし

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{"action": "common.api_key_info"}'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={"action": "common.api_key_info"}
)
key_info = resp.json()["data"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({ action: "common.api_key_info" })
});
const { data } = await resp.json();

7. メディア向けエンドポイント（13）

publisher または agent ロールで利用可能。

`publisher.programs_search`

公開案件を検索。カテゴリ・報酬タイプ・キーワード・最低報酬額でフィルタ。

パラメータ	型	説明
`category_id`	integer	カテゴリID
`category_slug`	string	カテゴリスラッグ（例: ai-chatbot）
`reward_type`	string	cpa / cpc / cpi
`keyword`	string	キーワード検索（案件名・説明文）
`min_reward`	integer	最低報酬額（円）
`self_affiliate`	boolean	セルフバック可能のみ
`min_confirmation_rate`	integer	最低確定率（%）
`allow_listing`	boolean	リスティング広告OK案件のみ
`has_product_link`	boolean	商品リンクあり案件のみ
`itp_supported`	boolean	ITP対応済み案件のみ
`is_campaign`	boolean	キャンペーン中の案件のみ
`is_new`	boolean	新着案件のみ
`auto_approve`	boolean	即時提携案件のみ
`sort`	string	newest / reward_desc / reward_asc / name / confirmation_rate_desc / epc_desc
`page`	integer	ページ番号（デフォルト: 1）
`per_page`	integer	件数（デフォルト: 20、最大: 50）

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "publisher.programs_search",
    "params": {
      "category_slug": "ai-chatbot",
      "reward_type": "cpa",
      "min_reward": 1000
    }
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "publisher.programs_search",
        "params": {
            "category_slug": "ai-chatbot",
            "reward_type": "cpa",
            "min_reward": 1000
        }
    }
)
programs = resp.json()["data"]["programs"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "publisher.programs_search",
    params: {
      category_slug: "ai-chatbot",
      reward_type: "cpa",
      min_reward: 1000
    }
  })
});
const { data } = await resp.json();

`publisher.programs_detail`

案件詳細。報酬条件・Cookie期間・素材一覧・LP URL・現在の提携状況。

パラメータ	型	必須	説明
`program_id`	integer	必須	案件ID

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "publisher.programs_detail",
    "params": {"program_id": 42}
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "publisher.programs_detail",
        "params": {"program_id": 42}
    }
)
program = resp.json()["data"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "publisher.programs_detail",
    params: { program_id: 42 }
  })
});
const { data } = await resp.json();

`publisher.partnerships_apply` WRITE

案件に提携申請。auto_approveの案件は即時承認。

パラメータ	型	必須	説明
`program_id`	integer	必須	提携する案件ID

レスポンス: partnership_id, status, tracking_code

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "publisher.partnerships_apply",
    "params": {"program_id": 42}
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "publisher.partnerships_apply",
        "params": {"program_id": 42}
    }
)
result = resp.json()["data"]
# {"partnership_id": 15, "status": "approved", "tracking_code": "abc123..."}

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "publisher.partnerships_apply",
    params: { program_id: 42 }
  })
});
const { data } = await resp.json();

`publisher.partnerships_cancel` WRITE

pending状態の提携申請を取消。

パラメータ	型	必須	説明
`partnership_id`	integer	必須	取消する提携ID

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "publisher.partnerships_cancel",
    "params": {"partnership_id": 15}
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "publisher.partnerships_cancel",
        "params": {"partnership_id": 15}
    }
)
print(resp.json())

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "publisher.partnerships_cancel",
    params: { partnership_id: 15 }
  })
});
const { data } = await resp.json();

`publisher.partnerships_list`

提携一覧。tracking_code含む。ステータスでフィルタ可能。

パラメータ	型	説明
`status`	string	pending / approved / rejected / suspended
`page`	integer	ページ番号
`per_page`	integer	件数

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "publisher.partnerships_list",
    "params": {"status": "approved"}
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "publisher.partnerships_list",
        "params": {"status": "approved"}
    }
)
partnerships = resp.json()["data"]["partnerships"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "publisher.partnerships_list",
    params: { status: "approved" }
  })
});
const { data } = await resp.json();

`publisher.links_generate`

トラッキングリンク生成。URL・HTMLタグ・JSタグの3形式 + PR表示テンプレート。

パラメータ	型	必須	説明
`partnership_id`	integer	必須	承認済み提携ID

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "publisher.links_generate",
    "params": {"partnership_id": 15}
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "publisher.links_generate",
        "params": {"partnership_id": 15}
    }
)
links = resp.json()["data"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "publisher.links_generate",
    params: { partnership_id: 15 }
  })
});
const { data } = await resp.json();

`publisher.selfback_list`

セルフバック（自己申込）可能な案件一覧。報酬額順。

パラメータ	型	説明
`page`	integer	ページ番号
`per_page`	integer	件数

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{"action": "publisher.selfback_list"}'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={"action": "publisher.selfback_list"}
)
programs = resp.json()["data"]["programs"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({ action: "publisher.selfback_list" })
});
const { data } = await resp.json();

`publisher.selfback_apply` WRITE

セルフバック申請。提携+クリック+遷移URLをワンショットで処理。1案件1回限り。

パラメータ	型	必須	説明
`program_id`	integer	必須	案件ID

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "publisher.selfback_apply",
    "params": {"program_id": 42}
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "publisher.selfback_apply",
        "params": {"program_id": 42}
    }
)
result = resp.json()["data"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "publisher.selfback_apply",
    params: { program_id: 42 }
  })
});
const { data } = await resp.json();

`publisher.report`

成果レポート。期間指定、案件別・日別集計。クリック統計含む。

パラメータ	型	説明
`start_date`	string	YYYY-MM-DD（デフォルト: 月初）
`end_date`	string	YYYY-MM-DD（デフォルト: 今日）
`group_by`	string	program / daily

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "publisher.report",
    "params": {
      "start_date": "2026-03-01",
      "end_date": "2026-03-31",
      "group_by": "daily"
    }
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "publisher.report",
        "params": {
            "start_date": "2026-03-01",
            "end_date": "2026-03-31",
            "group_by": "daily"
        }
    }
)
report = resp.json()["data"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "publisher.report",
    params: {
      start_date: "2026-03-01",
      end_date: "2026-03-31",
      group_by: "daily"
    }
  })
});
const { data } = await resp.json();

`publisher.earnings_summary`

報酬サマリー。未振込残高・今月報酬・累計・振込済み・月別推移6ヶ月。

パラメータ: なし

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{"action": "publisher.earnings_summary"}'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={"action": "publisher.earnings_summary"}
)
earnings = resp.json()["data"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({ action: "publisher.earnings_summary" })
});
const { data } = await resp.json();

`publisher.earnings_payouts`

振込履歴。総報酬・源泉徴収・手数料・振込額を含む。

パラメータ	型	説明
`page`	integer	ページ番号
`per_page`	integer	件数

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{"action": "publisher.earnings_payouts"}'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={"action": "publisher.earnings_payouts"}
)
payouts = resp.json()["data"]["payouts"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({ action: "publisher.earnings_payouts" })
});
const { data } = await resp.json();

`publisher.notifications_list`

通知一覧。未読のみフィルタ可能。

パラメータ	型	説明
`unread_only`	boolean	未読のみ取得
`page`	integer	ページ番号
`per_page`	integer	件数

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "publisher.notifications_list",
    "params": {"unread_only": true}
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "publisher.notifications_list",
        "params": {"unread_only": True}
    }
)
notifications = resp.json()["data"]["notifications"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "publisher.notifications_list",
    params: { unread_only: true }
  })
});
const { data } = await resp.json();

`publisher.notifications_read` WRITE

通知を既読にする。ID指定で単一、省略で全既読。

パラメータ	型	説明
`notification_id`	integer	通知ID（省略で全既読）

curl

# 特定の通知を既読
curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "publisher.notifications_read",
    "params": {"notification_id": 5}
  }'

# 全通知を既読
curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{"action": "publisher.notifications_read"}'

Python

import requests

# 特定の通知を既読
resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "publisher.notifications_read",
        "params": {"notification_id": 5}
    }
)

# 全通知を既読
resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={"action": "publisher.notifications_read"}
)

JavaScript

// 特定の通知を既読
const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "publisher.notifications_read",
    params: { notification_id: 5 }
  })
});

8. エージェント向けエンドポイント（6）

agent ロール専用。A2A送客・IoTデバイス連携に最適。

`agent.recommend`

ユーザーの要件からマッチする案件を推薦。A2A送客に最適。

パラメータ	型	説明
`use_case`	string	用途（例: コード自動生成、画像生成）
`category_slug`	string	カテゴリスラッグ
`category_id`	integer	カテゴリID
`reward_type`	string	cpa / cpc / cpi
`limit`	integer	取得件数（デフォルト: 5、最大: 20）

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "agent.recommend",
    "params": {
      "use_case": "画像生成",
      "limit": 5
    }
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "agent.recommend",
        "params": {
            "use_case": "画像生成",
            "limit": 5
        }
    }
)
recommendations = resp.json()["data"]["programs"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "agent.recommend",
    params: {
      use_case: "画像生成",
      limit: 5
    }
  })
});
const { data } = await resp.json();

`agent.program_detail`

案件の公開情報+素材一覧を取得。推薦結果の詳細確認用。

パラメータ	型	必須	説明
`program_id`	integer	必須	案件ID

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "agent.program_detail",
    "params": {"program_id": 42}
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "agent.program_detail",
        "params": {"program_id": 42}
    }
)
program = resp.json()["data"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "agent.program_detail",
    params: { program_id: 42 }
  })
});
const { data } = await resp.json();

`agent.track_click` WRITE

エージェント経由のクリックを記録。contextでデバイス種別を記録可能。

パラメータ	型	必須	説明
`partnership_id`	integer	必須	提携ID
`context`	string		voice-assistant / iot-device / chatbot 等
`user_agent`	string		ユーザーエージェント

レスポンス: click_id, tracking_url, lp_url

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "agent.track_click",
    "params": {
      "partnership_id": 15,
      "context": "voice-assistant"
    }
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "agent.track_click",
        "params": {
            "partnership_id": 15,
            "context": "voice-assistant"
        }
    }
)
result = resp.json()["data"]
# {"click_id": 123, "tracking_url": "https://...", "lp_url": "https://..."}

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "agent.track_click",
    params: {
      partnership_id: 15,
      context: "voice-assistant"
    }
  })
});
const { data } = await resp.json();

`agent.record_conversion` WRITE

コンバージョン記録。order_idで重複防止。

パラメータ	型	必須	説明
`tracking_code`	string	必須	トラッキングコード（32桁hex）
`order_id`	string		注文ID（重複防止用）
`amount`	integer		成果金額（円）

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{
    "action": "agent.record_conversion",
    "params": {
      "tracking_code": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
      "order_id": "ORDER-001",
      "amount": 9800
    }
  }'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={
        "action": "agent.record_conversion",
        "params": {
            "tracking_code": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
            "order_id": "ORDER-001",
            "amount": 9800
        }
    }
)
result = resp.json()["data"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({
    action: "agent.record_conversion",
    params: {
      tracking_code: "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
      order_id: "ORDER-001",
      amount: 9800
    }
  })
});
const { data } = await resp.json();

`agent.catalog`

全公開案件カタログ（軽量版: 名前・カテゴリ・報酬のみ）。初回ロードやキャッシュ用。

パラメータ: なし

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{"action": "agent.catalog"}'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={"action": "agent.catalog"}
)
catalog = resp.json()["data"]["programs"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({ action: "agent.catalog" })
});
const { data } = await resp.json();

`agent.categories`

カテゴリ一覧（案件数付き）。

パラメータ: なし

curl

curl -X POST https://agentclick.ai/api/mcp.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aa_your_api_key" \
  -d '{"action": "agent.categories"}'

Python

import requests

resp = requests.post(
    "https://agentclick.ai/api/mcp.php",
    headers={"Authorization": "Bearer aa_your_api_key"},
    json={"action": "agent.categories"}
)
categories = resp.json()["data"]["categories"]

JavaScript

const resp = await fetch("https://agentclick.ai/api/mcp.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer aa_your_api_key"
  },
  body: JSON.stringify({ action: "agent.categories" })
});
const { data } = await resp.json();

9. エラーコード

HTTPステータス	意味	対処
`400`	Bad Request	リクエスト形式またはパラメータを確認
`401`	Unauthorized	APIキーが無効または未設定
`403`	Forbidden	ロールに権限がないアクション
`404`	Not Found	指定リソースが存在しない
`409`	Conflict	重複（既存提携、order_id重複等）
`422`	Unprocessable	必須パラメータの不足
`429`	Too Many Requests	レート制限超過。1分待って再試行

エラーレスポンスの形式:

{
  "success": false,
  "message": "エラーの説明"
}

10. ロール別アクセス権

ロール	共通（5）	メディア（13）	エージェント（6）
`publisher`	利用可	利用可	利用不可
`advertiser`	利用可	利用不可	利用不可
`agent`	利用可	利用可	利用可

agentロールはメディア向け+エージェント向けの全エンドポイントにアクセスできます。AIエージェントによる自律的な運用に最適です。

11. Python サンプルコード

Python から REST API を直接呼び出すサンプルです。requests ライブラリを使用します。

セットアップ

# requests をインストール（未インストールの場合）
pip install requests

基本的な使い方

import requests

API_URL = "https://agentclick.ai/api/mcp.php"
API_KEY = "aa_your_api_key"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

def call(action, params=None):
    res = requests.post(API_URL, json={"action": action, "params": params or {}}, headers=HEADERS)
    res.raise_for_status()
    return res.json()

# 案件カタログ取得
catalog = call("agent.catalog")
for program in catalog["data"]:
    print(program["name"], program["reward_amount"])

案件検索と提携

# キーワード検索
results = call("publisher.programs_search", {"keyword": "AI", "reward_type": "cpa"})

# 提携申請
partnership = call("publisher.partnerships_apply", {"program_id": 1})

# アフィリエイトリンク生成
link = call("publisher.links_generate", {"partnership_id": partnership["data"]["id"]})

エージェント向け

# おすすめ案件を取得
recommendations = call("agent.recommend", {"use_case": "チャットボット開発", "limit": 5})

# クリック記録
click = call("agent.track_click", {"partnership_id": 1, "context": "line-bot"})

# コンバージョン記録
call("agent.record_conversion", {"tracking_code": "abc123...", "amount": 5000})

12. JavaScript サンプルコード

Node.js / ブラウザから REST API を直接呼び出すサンプルです。

基本的な使い方

const API_URL = 'https://agentclick.ai/api/mcp.php'
const API_KEY = 'aa_your_api_key'

async function call(action, params = {}) {
    const res = await fetch(API_URL, {
        method: 'POST',
        headers: { 'Authorization': `Bearer ${API_KEY}`, 'Content-Type': 'application/json' },
        body: JSON.stringify({ action, params })
    })
    if (!res.ok) throw new Error(await res.text())
    return res.json()
}

// 案件カタログ取得
const catalog = await call('agent.catalog')
catalog.data.forEach(p => console.log(p.name, p.reward_amount))

案件検索と提携

// キーワード検索
const results = await call('publisher.programs_search', { keyword: 'AI', reward_type: 'cpa' })

// 提携申請
const partnership = await call('publisher.partnerships_apply', { program_id: 1 })

// アフィリエイトリンク生成
const link = await call('publisher.links_generate', { partnership_id: partnership.data.id })

エージェント向け

// おすすめ案件を取得
const recs = await call('agent.recommend', { use_case: 'chatbot', limit: 5 })

// クリック記録
const click = await call('agent.track_click', { partnership_id: 1, context: 'x-bot' })

// コンバージョン記録
await call('agent.record_conversion', { tracking_code: 'abc123...', amount: 5000 })

今すぐ開発を始めましょう

無料登録してAPIキーを発行。すぐにAIエージェント連携を開始できます。

開発者ガイド REST API MCPドキュメント

概要
認証
リクエスト形式
レスポンス形式
レート制限
共通エンドポイント（5）
メディア向けエンドポイント（13）
エージェント向けエンドポイント（6）
エラーコード
ロール別アクセス権
Python サンプル
JavaScript サンプル

AI時代のアフィリエイトASP

アフィリエイトを始めたい方無料でメディア登録する広告出稿をお考えの広告主様無料で広告出稿をする

REST API ドキュメント

1. 概要

2. 認証

3. リクエスト形式

4. レスポンス形式

5. レート制限

6. 共通エンドポイント（5）

health

curl

Python

JavaScript

common.categories

curl

Python

JavaScript

common.stats

curl

Python

JavaScript

common.profile

curl

Python

JavaScript

common.api_key_info

curl

Python

JavaScript

7. メディア向けエンドポイント（13）

publisher.programs_search

curl

Python

JavaScript

publisher.programs_detail

curl

Python

JavaScript

publisher.partnerships_apply WRITE

curl

Python

JavaScript

publisher.partnerships_cancel WRITE

curl

Python

JavaScript

publisher.partnerships_list

curl

Python

JavaScript

publisher.links_generate

curl

Python

JavaScript

publisher.selfback_list

curl

Python

JavaScript

publisher.selfback_apply WRITE

curl

Python

JavaScript

publisher.report

curl

Python

JavaScript

publisher.earnings_summary

curl

Python

JavaScript

publisher.earnings_payouts

curl

Python

JavaScript

publisher.notifications_list

curl

Python

JavaScript

publisher.notifications_read WRITE

curl

Python

JavaScript

`health`

`common.categories`

`common.stats`

`common.profile`

`common.api_key_info`

`publisher.programs_search`

`publisher.programs_detail`

`publisher.partnerships_apply` WRITE

`publisher.partnerships_cancel` WRITE

`publisher.partnerships_list`

`publisher.links_generate`

`publisher.selfback_list`

`publisher.selfback_apply` WRITE

`publisher.report`

`publisher.earnings_summary`

`publisher.earnings_payouts`

`publisher.notifications_list`

`publisher.notifications_read` WRITE

`agent.recommend`

`agent.program_detail`

`agent.track_click` WRITE

`agent.record_conversion` WRITE

`agent.catalog`

`agent.categories`