AdCP — get

ブランドエージェントのロスター全体でライセンス可能な権利を検索します。価格オプション付きのマッチを返します。探索は自然言語ファースト — タクソノミーなし、LLM がクエリから意図を解釈します。

スキーマ

リクエスト: get-rights-request.json
レスポンス: get-rights-response.json

応答時間

通常2〜10秒。エージェントがバイヤーの brand.json に対して互換性チェックを行う場合、遅延が増加します。

クイックスタート

{
  "query": "Dutch athlete for restaurant brand in Amsterdam, budget 400 EUR/month",
  "uses": ["likeness", "voice"],
  "buyer_brand": { "domain": "bistro-oranje.nl" },
  "include_excluded": true
}

{
  "rights": [
    {
      "rights_id": "janssen_likeness_voice",
      "brand_id": "daan_janssen",
      "name": "Daan Janssen",
      "description": "Dutch Olympic speed skater, 2x gold medalist",
      "right_type": "talent",
      "match_score": 0.92,
      "match_reasons": [
        "Available for food/restaurant brands in NL",
        "Within budget at 350 EUR/month",
        "Athletic brand aligns with Bistro Oranje's quality positioning"
      ],
      "available_uses": ["likeness", "voice", "name", "endorsement"],
      "countries": ["NL", "BE", "DE"],
      "pricing_options": [
        {
          "pricing_option_id": "cpm_endorsement",
          "model": "cpm",
          "price": 3.50,
          "currency": "EUR",
          "uses": ["likeness"],
          "description": "Per-impression royalty for AI-generated creatives using likeness"
        },
        {
          "pricing_option_id": "monthly_exclusive",
          "model": "flat_rate",
          "price": 350,
          "currency": "EUR",
          "period": "monthly",
          "uses": ["likeness", "voice"],
          "impression_cap": 100000,
          "overage_cpm": 4.00,
          "description": "Monthly exclusive license for likeness + voice, up to 100K impressions"
        }
      ],
      "content_restrictions": ["approval_required"],
      "preview_assets": [
        { "url": "https://cdn.lotientertainment.com/janssen/headshot.jpg", "usage": "preview_only" }
      ]
    }
  ],
  "excluded": [
    {
      "brand_id": "pieter_van_dijk",
      "name": "Pieter van Dijk",
      "reason": "Dietary lifestyle conflict with steakhouse brand",
      "suggestions": ["Available for plant-based and health food brands"]
    }
  ]
}

パラメーター

リクエスト

フィールド	型	必須	説明
`query`	string	Yes	希望する権利の自然言語での説明。予算、地域、ユースケースを含めます。
`uses`	string[]	Yes	リクエストする権利の使用（`likeness`、`voice`、`name`、`endorsement` など）
`buyer_brand`	brand-ref	No	バイヤーのブランド。エージェントが互換性フィルタリングのためにバイヤーの brand.json を取得します。
`countries`	string[]	No	権利が必要な国（ISO 3166-1 alpha-2）
`brand_id`	string	No	特定のブランドの権利内を検索
`right_type`	string	No	権利タイプでフィルタリング（`talent`、`music`、`stock_media` など）
`include_excluded`	boolean	No	フィルタリングされた結果を理由とともに `excluded` 配列に含めます。デフォルトは false。
`pagination`	object	No	大きな結果セットのページネーションパラメーター

レスポンス

フィールド	型	説明
`rights`	object[]	価格付きのマッチ、関連性順でランク付け
`rights[].rights_id`	string	このオファリングの識別子 — `acquire_rights` で参照される
`rights[].brand_id`	string	ブランド識別子
`rights[].name`	string	表示名
`rights[].match_score`	number	関連性スコア（0〜1）
`rights[].match_reasons`	string[]	この結果がマッチする理由
`rights[].available_uses`	string[]	利用可能な権利の使用
`rights[].countries`	string[]	利用可能な国
`rights[].excluded_countries`	string[]	可用性から除外された国
`rights[].exclusivity_status`	object	現在の独占可用性（`available`、`existing_exclusives`）
`rights[].pricing_options`	object[]	価格オプション（以下参照）
`rights[].description`	string	権利の対象の説明
`rights[].right_type`	string	権利のタイプ（`talent`、`music`、`stock_media` など）
`rights[].content_restrictions`	string[]	コンテンツ制限または承認要件
`rights[].preview_assets`	object[]	評価用のプレビューのみのアセット
`excluded`	object[]	理由付きのフィルタリング済み結果（`include_excluded: true` の場合のみ）
`excluded[].suggestions`	string[]	除外が修正可能な場合の実行可能な代替案。除外が最終的な場合は省略。

権利価格オプション

価格オプションは権利に特有 — 期間、インプレッション上限、超過レート、使用タイプのスコーピングを含みます:

フィールド	型	必須	説明
`pricing_option_id`	string	Yes	`acquire_rights` と `report_usage` で参照される
`model`	string	Yes	価格モデル（`cpm`、`flat_rate` など）
`price`	number	Yes	価格金額
`currency`	string	Yes	ISO 4217 通貨コード
`uses`	string[]	Yes	このオプションでカバーされる権利の使用
`period`	string	No	請求期間（`monthly`、`quarterly` など）
`impression_cap`	integer	No	期間あたりの最大インプレッション数
`overage_cpm`	number	No	上限を超えたインプレッションの CPM

複合権利

複数の使用をリクエスト（例: ["likeness", "voice"]）すると、エージェントはそれらを単一の価格オプションにバンドルします。1回の呼び出し、1つの価格。

バイヤーブランドフィルタリング

buyer_brand が提供されると、エージェントはバイヤーの brand.json を取得して互換性フィルタリングに使用します。例えば、ベジタリアンのアスリートはステーキハウスのキャンペーンから除外されます。フィルタリングされた結果と理由を見るには include_excluded: true を設定します。

音楽ライセンスと DDEX

このセクションは音楽権利エージェントを構築する実装者向け。ブランドプロトコルを使用するバイヤーであれば、標準の get_rights と acquire_rights フローは音楽でも同じように機能する — DDEX を知る必要はない。

権利プロトコルはタレント権利と並行して音楽ライセンスをサポートします。音楽シンクプラットフォームは right_type: "music" で get_rights を実装し、シンク/バックグラウンド使用の価格オプションを返します。 AdCP の権利モデルは DDEX の Party Information Exchange (PIE) パターンを参考にしている — 各 get_rights レスポンスは以前の状態に対するデルタではなく、現在の可用性のステートレスなスナップショットです。DDEX を熟知している実装者向けのマッピング:

AdCP コンセプト	DDEX の同等物	備考
`rights_id`	ISRC / ISWC	AdCP はエージェントスコープの ID を使用; 標準識別子は `ext` に含める
`available_uses`	使用タイプ（シンク、バックグラウンドなど）	AdCP は `right-use` enum 値を使用
`pricing_options`	ライセンスオファー	同じコンセプト、異なる構造
`content_restrictions`	地域/使用制限	AdCP は DDEX より粒度が低い
`acquire_rights`	ライセンス付与	AI 音楽制作の生成資格情報を返す

音楽権利エージェントは、既存の音楽ライセンスシステムとの相互運用性のために、権利レスポンスの ext フィールドに標準識別子（ISRC、ISWC）を含めるべきです。

次のステップ

権利オファリングを選択した後:

選択したブランドの完全なアイデンティティデータを取得するために get_brand_identity を呼び出す
rights_id と pricing_option_id を使って acquire_rights を呼び出す

はじめに

AdCP で構築する

プロトコル

FAQ

トラストとセキュリティ

リファレンス

AAO

認定

get_rights

スキーマ

応答時間

クイックスタート

パラメーター

リクエスト

レスポンス

権利価格オプション

複合権利

バイヤーブランドフィルタリング

音楽ライセンスと DDEX

次のステップ

​スキーマ

​応答時間

​クイックスタート

​パラメーター

​リクエスト

​レスポンス

​権利価格オプション

​複合権利

​バイヤーブランドフィルタリング

​音楽ライセンスと DDEX

​次のステップ

スキーマ

応答時間

クイックスタート

パラメーター

リクエスト

レスポンス

権利価格オプション

複合権利

バイヤーブランドフィルタリング

音楽ライセンスと DDEX

次のステップ