Gemlead
Docs
ログイン
APIキーを取得

APIリファレンス

ペルソナ

ペルソナとは、予想家や代理店のオーナーのように、アプローチしたい買い手のタイプです。Gemleadは有効なペルソナごとにリードを探し、ペルソナの説明と照らしてスコアリングします。Gemleadがどこを探すかは、ペルソナのソースで決まります。

複数のXアカウントを持つオーナーは、ペルソナをそれらのアカウントで共有できます。各アカウントは同じソース、設定、リードを使い、キャンペーンはそれぞれ別に持ちます。リードは1つのXアカウントにしか割り当てられません。どのXアカウントで共有するかはペルソナの共有で決めます。

エンドポイント

ペルソナオブジェクト

アプローチしたい買い手のタイプ。Gemleadは有効な各ペルソナに合うリードを探し、そのペルソナと照らしてスコアリングします。

属性

  • idstring
    ペルソナの一意の識別子。
  • objectstring
    常にpersonaです。
  • namestring
    Tipstersのような、ペルソナの短い名前。
  • descriptionstring
    この買い手がどんな人かを、あなたの言葉で説明したもの。スコアリングではこれを読みます。
  • marketstring
    販売先が企業か、個人の消費者か。
    b2bb2c
  • statusstring
    このペルソナのリードをGemleadが探しているかどうか。
    activepaused
  • websitestringまたはnull
    このペルソナに販売する商材のウェブサイト。
  • statsobject
    ペルソナの作成以降の件数と、プロフィールのタイムゾーンでの今日の件数。
  • sharingobject
    ペルソナを共有しているオーナーのXアカウント。詳しくはペルソナの共有を参照してください。
  • created_atstring
    ペルソナが作成された日時。ISO 8601形式です。
  • updated_atstring
    ペルソナが最後に変更された日時。ISO 8601形式です。
ペルソナオブジェクト
{
  "id": "lvWBPnytpS",
  "object": "persona",
  "name": "Tipsters",
  "description": "Sports and trading tipsters who sell picks or signals to a paying community.",
  "market": "b2c",
  "status": "active",
  "website": "https://example.com",
  "stats": {
    "leads_found": 18420,
    "leads_scored": 17960,
    "hot_leads": 2134,
    "avg_score": 41,
    "today": {
      "leads_found": 312,
      "hot_leads": 38,
      "dms_sent": 25,
      "replies": 4
    }
  },
  "sharing": {
    "home_account": {
      "id": "a9PzK2vRtM",
      "username": "acme"
    },
    "shared_with": [
      {
        "id": "Hq4TnW8cLm",
        "username": "acme_sales"
      }
    ]
  },
  "created_at": "2026-09-14T09:21:05.300Z",
  "updated_at": "2026-11-06T07:45:12.904Z"
}

ペルソナを一覧表示

GET/v1/personasreadスコープMCPlist_personas

ペルソナページと同じ順番でペルソナを返します。

クエリパラメーター

  • limitinteger
    返すオブジェクトの数。1から100まで指定でき、デフォルトは25です。
  • cursorstring
    次のページを取得するための、前のページのnext_cursor。ページネーションを参照してください。

戻り値

ペルソナオブジェクトのリスト。

GET/v1/personas
curl https://gemlead.ai/api/v1/personas \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
レスポンス200
{
  "object": "list",
  "data": [
    {
      "id": "lvWBPnytpS",
      "object": "persona",
      "name": "Tipsters",
      "description": "Sports and trading tipsters who sell picks or signals to a paying community.",
      "market": "b2c",
      "status": "active",
      "website": "https://example.com",
      "stats": {
        "leads_found": 18420,
        "leads_scored": 17960,
        "hot_leads": 2134,
        "avg_score": 41,
        "today": {
          "leads_found": 312,
          "hot_leads": 38,
          "dms_sent": 25,
          "replies": 4
        }
      },
      "sharing": {
        "home_account": {
          "id": "a9PzK2vRtM",
          "username": "acme"
        },
        "shared_with": [
          {
            "id": "Hq4TnW8cLm",
            "username": "acme_sales"
          }
        ]
      },
      "created_at": "2026-09-14T09:21:05.300Z",
      "updated_at": "2026-11-06T07:45:12.904Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

ペルソナを取得

GET/v1/personas/:idreadスコープMCPget_persona

ペルソナを1件、統計とともに返します。

パスパラメーター

  • idstring必須
    ペルソナのID。

戻り値

ペルソナオブジェクト。

エラー

  • 404resource_missing
    キーのアカウントに、このIDのペルソナはありません。
GET/v1/personas/:id
curl https://gemlead.ai/api/v1/personas/lvWBPnytpS \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
レスポンス200
{
  "id": "lvWBPnytpS",
  "object": "persona",
  "name": "Tipsters",
  "description": "Sports and trading tipsters who sell picks or signals to a paying community.",
  "market": "b2c",
  "status": "active",
  "website": "https://example.com",
  "stats": {
    "leads_found": 18420,
    "leads_scored": 17960,
    "hot_leads": 2134,
    "avg_score": 41,
    "today": {
      "leads_found": 312,
      "hot_leads": 38,
      "dms_sent": 25,
      "replies": 4
    }
  },
  "sharing": {
    "home_account": {
      "id": "a9PzK2vRtM",
      "username": "acme"
    },
    "shared_with": [
      {
        "id": "Hq4TnW8cLm",
        "username": "acme_sales"
      }
    ]
  },
  "created_at": "2026-09-14T09:21:05.300Z",
  "updated_at": "2026-11-06T07:45:12.904Z"
}

ペルソナを作成

POST/v1/personaswriteスコープMCPcreate_persona

ペルソナを作成し、すぐにリードを探し始めます。スコアリングではリード1件につき最大2クレジットを使います。1回目の分析で1クレジット、通過すると2回目の分析でさらに1クレジットです。スコアリングするのは1日あたりdaily_scoring_limit件までです。ソースは今すぐ、またはあとからソースを追加で追加できます。

ボディパラメーター

  • namestring必須
    ペルソナの名前。Ghostwritersのように1語から3語で、100文字までです。
  • websitestring
    あなたの商材のウェブサイト。500文字までです。リードをスコアリングするAIがこれを読みます。
  • descriptionstring必須
    この買い手がどんな人かを、ふだんの言葉で説明します。AIはこれと照らしてすべてのリードを0から100でスコアリングするため、最も重要な項目です。独自のスコアリングルールを含めることもできます。12 000文字までです。
  • marketstring
    企業が購入する場合はb2b、個人が自分のために購入する場合はb2c。デフォルトはb2bです。
    b2bb2c
  • keywordsstringsの配列
    プロフィールやポストに含まれていると相性の良さを示す語句。最大100個で、それぞれ100文字までです。
  • competitorsstringsの配列
    あなたの商材に似た製品。それを使っている人は相性が良いと判断されます。最大100個です。
  • avoidstringsの配列
    agenciesやstudentsのように、低くスコアリングする対象。最大100個です。
  • min_followersinteger
    フォロワーがこの数より少ないプロフィールはスコアリングされません。0から10 000 000まで指定でき、デフォルトは100です。
  • include_closed_inboxesboolean
    DMを閉じている人もスコアリングします。キャンペーンはリプライでアプローチします。デフォルトはtrueです。
  • auto_expandboolean
    ほかのソースが尽きたとき、Gemleadが有望なリードから自動でソースを追加します。デフォルトはfalseです。
  • auto_expand_directionstring
    自動拡張の次の方向性を、more US foundersのようにふだんの言葉で指定します。500文字までです。
  • daily_scoring_limitinteger
    このペルソナで1日にスコアリングするリードの上限。リード1件につき最大2クレジットを使います。1回目の分析で1クレジット、通過すると2回目の分析でさらに1クレジットです。100から20 000まで指定できます。デフォルトはプランのペースで、Starterは1日3 300件、Businessは10 000件です。
  • sourcesobjectsの配列
    最大20件の初期ソース。投資家、アクセラレーター、メディアのアカウントは買い手につながらないため、受け付けられません。

戻り値

新しいペルソナオブジェクト。

エラー

  • 400parameter_missing
    必須パラメーターがありません。paramにその名前が入ります。
  • 400parameter_invalid
    APIが受け付けない値のパラメーターがあります。paramにその名前が入ります。
  • 400parameter_unknown
    ボディに、このエンドポイントが受け付けないフィールドがあります。
  • 400limit_reached
    アカウントにはすでに100件のペルソナがあります。
  • 400seed_source_refused
    投資家やメディアのアカウントなど、受け付けられない初期ソースがあります。paramはsourcesです。
POST/v1/personas
curl -X POST https://gemlead.ai/api/v1/personas \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tipsters",
    "description": "Sports and trading tipsters who sell picks or signals to a paying community.",
    "market": "b2c",
    "keywords": ["tipster", "betting tips"],
    "sources": [
      {
        "username": "pickswithmike"
      }
    ]
  }'
レスポンス200
{
  "id": "lvWBPnytpS",
  "object": "persona",
  "name": "Tipsters",
  "description": "Sports and trading tipsters who sell picks or signals to a paying community.",
  "market": "b2c",
  "status": "active",
  "website": "https://example.com",
  "stats": {
    "leads_found": 18420,
    "leads_scored": 17960,
    "hot_leads": 2134,
    "avg_score": 41,
    "today": {
      "leads_found": 312,
      "hot_leads": 38,
      "dms_sent": 25,
      "replies": 4
    }
  },
  "sharing": {
    "home_account": {
      "id": "a9PzK2vRtM",
      "username": "acme"
    },
    "shared_with": [
      {
        "id": "Hq4TnW8cLm",
        "username": "acme_sales"
      }
    ]
  },
  "created_at": "2026-09-14T09:21:05.300Z",
  "updated_at": "2026-11-06T07:45:12.904Z"
}

ペルソナを有効化

POST/v1/personas/:persona_id/activatewriteスコープMCPupdate_persona

一時停止中のペルソナを再び開始します。ソースの読み取りとリードのスコアリングが再開されます。

パスパラメーター

  • persona_idstring必須
    ペルソナのID。

戻り値

ペルソナオブジェクト。

エラー

  • 404resource_missing
    キーのアカウントに、このIDのペルソナはありません。
POST/v1/personas/:persona_id/activate
curl -X POST \
  https://gemlead.ai/api/v1/personas/lvWBPnytpS/activate \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
レスポンス200
{
  "id": "lvWBPnytpS",
  "object": "persona",
  "name": "Tipsters",
  "description": "Sports and trading tipsters who sell picks or signals to a paying community.",
  "market": "b2c",
  "status": "active",
  "website": "https://example.com",
  "stats": {
    "leads_found": 18420,
    "leads_scored": 17960,
    "hot_leads": 2134,
    "avg_score": 41,
    "today": {
      "leads_found": 312,
      "hot_leads": 38,
      "dms_sent": 25,
      "replies": 4
    }
  },
  "sharing": {
    "home_account": {
      "id": "a9PzK2vRtM",
      "username": "acme"
    },
    "shared_with": [
      {
        "id": "Hq4TnW8cLm",
        "username": "acme_sales"
      }
    ]
  },
  "created_at": "2026-09-14T09:21:05.300Z",
  "updated_at": "2026-11-06T07:45:12.904Z"
}

ペルソナを一時停止

POST/v1/personas/:persona_id/pausewriteスコープMCPupdate_persona

ペルソナを一時停止します。Gemleadはソースの読み取りとリードのスコアリングを止めますが、リードはそのまま残ります。

パスパラメーター

  • persona_idstring必須
    ペルソナのID。

戻り値

statusがpausedのペルソナオブジェクト。

エラー

  • 404resource_missing
    キーのアカウントに、このIDのペルソナはありません。
POST/v1/personas/:persona_id/pause
curl -X POST \
  https://gemlead.ai/api/v1/personas/lvWBPnytpS/pause \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
レスポンス200
{
  "id": "lvWBPnytpS",
  "object": "persona",
  "name": "Tipsters",
  "description": "Sports and trading tipsters who sell picks or signals to a paying community.",
  "market": "b2c",
  "status": "paused",
  "website": "https://example.com",
  "stats": {
    "leads_found": 18420,
    "leads_scored": 17960,
    "hot_leads": 2134,
    "avg_score": 41,
    "today": {
      "leads_found": 312,
      "hot_leads": 38,
      "dms_sent": 25,
      "replies": 4
    }
  },
  "sharing": {
    "home_account": {
      "id": "a9PzK2vRtM",
      "username": "acme"
    },
    "shared_with": [
      {
        "id": "Hq4TnW8cLm",
        "username": "acme_sales"
      }
    ]
  },
  "created_at": "2026-09-14T09:21:05.300Z",
  "updated_at": "2026-11-06T07:45:12.904Z"
}

ペルソナを削除

DELETE/v1/personas/:persona_idwriteスコープMCPdelete_persona

ペルソナを、そのソースと、どのキャンペーンでも扱っていないリードとともに削除します。ペルソナのキャンペーンはアーカイブされます。この操作は元に戻せません。

パスパラメーター

  • persona_idstring必須
    ペルソナのID。

戻り値

ペルソナのid、trueに設定されたdeleted、archived_campaignsとdeleted_sourcesの件数を含むオブジェクト。リードはバックグラウンドで削除されるため、deleted_leadsはnullになり、数分間はリードを一覧表示に表示されることがあります。

エラー

  • 404resource_missing
    キーのアカウントに、このIDのペルソナはありません。
DELETE/v1/personas/:persona_id
curl -X DELETE https://gemlead.ai/api/v1/personas/lvWBPnytpS \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
レスポンス200
{
  "id": "lvWBPnytpS",
  "object": "persona",
  "deleted": true,
  "archived_campaigns": 1,
  "deleted_sources": 6,
  "deleted_leads": null
}

ペルソナを並べ替え

POST/v1/personas/reorderwriteスコープMCPreorder_personas

アプリでの表示順と同じく、ペルソナの並び順を設定します。すべてのペルソナを1回ずつ送ってください。

ボディパラメーター

  • persona_idsstringsの配列必須
    アカウントのすべてのペルソナIDを、新しい順番で並べたもの。

戻り値

新しい順番に並んだペルソナオブジェクトのリスト。

エラー

  • 400parameter_missing
    必須パラメーターがありません。paramにその名前が入ります。
  • 400parameter_invalid
    APIが受け付けない値のパラメーターがあります。paramにその名前が入ります。
  • 404resource_missing
    アカウントのペルソナではないIDがあります。
POST/v1/personas/reorder
curl -X POST https://gemlead.ai/api/v1/personas/reorder \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "persona_ids": ["lvWBPnytpS", "pQ8nX2rTjk"]
  }'
レスポンス200
{
  "object": "list",
  "data": [
    {
      "id": "lvWBPnytpS",
      "object": "persona",
      "name": "Tipsters",
      "description": "Sports and trading tipsters who sell picks or signals to a paying community.",
      "market": "b2c",
      "status": "active",
      "website": "https://example.com",
      "stats": {
        "leads_found": 18420,
        "leads_scored": 17960,
        "hot_leads": 2134,
        "avg_score": 41,
        "today": {
          "leads_found": 312,
          "hot_leads": 38,
          "dms_sent": 25,
          "replies": 4
        }
      },
      "sharing": {
        "home_account": {
          "id": "a9PzK2vRtM",
          "username": "acme"
        },
        "shared_with": [
          {
            "id": "Hq4TnW8cLm",
            "username": "acme_sales"
          }
        ]
      },
      "created_at": "2026-09-14T09:21:05.300Z",
      "updated_at": "2026-11-06T07:45:12.904Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

ペルソナ設定オブジェクト

ペルソナが見つけるリードと、AIによるスコアリングを決めるすべての設定。アプリのペルソナページで編集できる内容と同じです。

属性

  • objectstring
    常にpersona_settingsです。
  • persona_idstring
    ペルソナのID。
  • namestring
    Ghostwritersのように1語から3語の、ペルソナの名前。
  • websitestringまたはnull
    あなたの商材のウェブサイト。リードをスコアリングするAIがこれを読みます。
  • descriptionstringまたはnull
    この買い手がどんな人かを、ふだんの言葉で説明したもの。AIはこれと照らしてすべてのリードを0から100でスコアリングするため、最も重要な項目です。独自のスコアリングルールを含めることもできます。
  • marketstring
    企業が購入する場合はb2b、個人が自分のために購入する場合はb2c。
    b2bb2c
  • keywordsstringsの配列
    プロフィールやポストに含まれていると相性の良さを示す語句。
  • competitorsstringsの配列
    あなたの商材に似た製品。それを使っている人は相性が良いと判断されます。
  • avoidstringsの配列
    agenciesやstudentsのように、低くスコアリングする対象。
  • min_followersinteger
    フォロワーがこの数より少ないプロフィールはスコアリングされません。
  • include_closed_inboxesboolean
    DMを閉じている人もスコアリングするかどうか。キャンペーンはリプライでアプローチします。
  • auto_expandboolean
    ほかのソースが尽きたとき、Gemleadが有望なリードから自動でソースを追加するかどうか。
  • auto_expand_directionstringまたはnull
    more US foundersのような、ふだんの言葉で書いた自動拡張の次の方向性。
  • daily_scoring_limitinteger
    このペルソナで1日にスコアリングするリードの上限。リード1件につき最大2クレジットを使います。1回目の分析で1クレジット、通過すると2回目の分析でさらに1クレジットです。
  • statusstring
    Gemleadがこのペルソナのリードを探してスコアリングしているかどうか。
    activepaused
  • search_queriesstringsの配列
    ペルソナのキーワード検索。
  • competitor_accountsstringsの配列
    ペルソナの競合アカウント。@を除いたXのユーザー名です。
  • updated_atstring
    ペルソナが最後に変更された日時。ISO 8601形式です。
ペルソナ設定オブジェクト
{
  "object": "persona_settings",
  "persona_id": "lvWBPnytpS",
  "name": "Tipsters",
  "website": "https://example.com",
  "description": "Sports and trading tipsters who sell picks or signals to a paying community.",
  "market": "b2c",
  "status": "active",
  "keywords": ["tipster", "betting tips", "trading signals"],
  "competitors": ["Patreon", "Whop"],
  "avoid": ["betting brands", "news accounts"],
  "min_followers": 500,
  "include_closed_inboxes": true,
  "auto_expand": false,
  "auto_expand_direction": null,
  "daily_scoring_limit": 3300,
  "search_queries": ["paid discord picks", "vip tips telegram"],
  "competitor_accounts": ["whop"],
  "updated_at": "2026-11-06T07:45:12.904Z"
}

ペルソナ設定を取得

GET/v1/personas/:persona_id/settingsreadスコープMCPget_persona_settings

キーワード検索と競合アカウントを含む、ペルソナのすべての設定を返します。

パスパラメーター

  • persona_idstring必須
    ペルソナのID。

戻り値

ペルソナ設定オブジェクト。

エラー

  • 404resource_missing
    キーのアカウントに、このIDのペルソナはありません。
GET/v1/personas/:persona_id/settings
curl https://gemlead.ai/api/v1/personas/lvWBPnytpS/settings \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
レスポンス200
{
  "object": "persona_settings",
  "persona_id": "lvWBPnytpS",
  "name": "Tipsters",
  "website": "https://example.com",
  "description": "Sports and trading tipsters who sell picks or signals to a paying community.",
  "market": "b2c",
  "status": "active",
  "keywords": ["tipster", "betting tips", "trading signals"],
  "competitors": ["Patreon", "Whop"],
  "avoid": ["betting brands", "news accounts"],
  "min_followers": 500,
  "include_closed_inboxes": true,
  "auto_expand": false,
  "auto_expand_direction": null,
  "daily_scoring_limit": 3300,
  "search_queries": ["paid discord picks", "vip tips telegram"],
  "competitor_accounts": ["whop"],
  "updated_at": "2026-11-06T07:45:12.904Z"
}

ペルソナ設定を更新

PATCH/v1/personas/:persona_id/settingswriteスコープMCPupdate_persona

送信した設定だけを変更し、ほかの設定はそのまま残します。リストを送るとリスト全体が置き換わるため、既存の語句を残すには、新しい語句を加えたkeywordsを送ってください。

パスパラメーター

  • persona_idstring必須
    ペルソナのID。

ボディパラメーター

  • namestring
    ペルソナの名前。Ghostwritersのように1語から3語で、100文字までです。
  • websitestring
    あなたの商材のウェブサイト。500文字までです。リードをスコアリングするAIがこれを読みます。
  • descriptionstring
    この買い手がどんな人かを、ふだんの言葉で説明します。AIはこれと照らしてすべてのリードを0から100でスコアリングするため、最も重要な項目です。独自のスコアリングルールを含めることもできます。12 000文字までです。
  • marketstring
    企業が購入する場合はb2b、個人が自分のために購入する場合はb2c。デフォルトはb2bです。
    b2bb2c
  • keywordsstringsの配列
    プロフィールやポストに含まれていると相性の良さを示す語句。最大100個で、それぞれ100文字までです。
  • competitorsstringsの配列
    あなたの商材に似た製品。それを使っている人は相性が良いと判断されます。最大100個です。
  • avoidstringsの配列
    agenciesやstudentsのように、低くスコアリングする対象。最大100個です。
  • min_followersinteger
    フォロワーがこの数より少ないプロフィールはスコアリングされません。0から10 000 000まで指定でき、デフォルトは100です。
  • include_closed_inboxesboolean
    DMを閉じている人もスコアリングします。キャンペーンはリプライでアプローチします。デフォルトはtrueです。
  • auto_expandboolean
    ほかのソースが尽きたとき、Gemleadが有望なリードから自動でソースを追加します。デフォルトはfalseです。
  • auto_expand_directionstring
    自動拡張の次の方向性を、more US foundersのようにふだんの言葉で指定します。500文字までです。
  • daily_scoring_limitinteger
    このペルソナで1日にスコアリングするリードの上限。リード1件につき最大2クレジットを使います。1回目の分析で1クレジット、通過すると2回目の分析でさらに1クレジットです。ペルソナを共有するXアカウント1つにつき100から20 000まで指定できます。

戻り値

更新されたペルソナ設定オブジェクト。

エラー

  • 404resource_missing
    キーのアカウントに、このIDのペルソナはありません。
  • 400parameter_invalid
    APIが受け付けない値のパラメーターがあります。paramにその名前が入ります。
  • 400parameter_unknown
    ボディに、このエンドポイントが受け付けないフィールドがあります。
PATCH/v1/personas/:persona_id/settings
curl -X PATCH \
  https://gemlead.ai/api/v1/personas/lvWBPnytpS/settings \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "min_followers": 500,
    "avoid": ["betting brands", "news accounts"]
  }'
レスポンス200
{
  "object": "persona_settings",
  "persona_id": "lvWBPnytpS",
  "name": "Tipsters",
  "website": "https://example.com",
  "description": "Sports and trading tipsters who sell picks or signals to a paying community.",
  "market": "b2c",
  "status": "active",
  "keywords": ["tipster", "betting tips", "trading signals"],
  "competitors": ["Patreon", "Whop"],
  "avoid": ["betting brands", "news accounts"],
  "min_followers": 500,
  "include_closed_inboxes": true,
  "auto_expand": false,
  "auto_expand_direction": null,
  "daily_scoring_limit": 3300,
  "search_queries": ["paid discord picks", "vip tips telegram"],
  "competitor_accounts": ["whop"],
  "updated_at": "2026-11-06T07:45:12.904Z"
}

ペルソナ共有オブジェクト

同じペルソナを使う、同じオーナーのXアカウント。ソース、設定、リード、除外リストを共有し、キャンペーンはそれぞれのアカウントで実行します。リードは1つのXアカウントにしか割り当てられず、その割り当てはlocked_toでわかります。

属性

  • objectstring
    常にpersona_sharingです。
  • persona_idstring
    ペルソナのID。
  • home_accountobjectまたはnull
    ペルソナが作成されたXアカウント。ペルソナのソースとリードはこのアカウントにあります。
  • shared_withobjectsの配列
    ペルソナを共有しているほかのXアカウント。共有していなければ空です。
  • available_accountsobjectsの配列
    このペルソナを共有できる、オーナーのほかのXアカウント。チームメンバーは共有を変更できないため、常に空です。
  • daily_scoring_limitinteger
    グループ全体で、このペルソナが1日にスコアリングするリードの上限。ペルソナを共有するXアカウント1つにつき20 000まで上げられます。
ペルソナ共有オブジェクト
{
  "object": "persona_sharing",
  "persona_id": "lvWBPnytpS",
  "home_account": {
    "id": "a9PzK2vRtM",
    "username": "acme"
  },
  "shared_with": [
    {
      "id": "Hq4TnW8cLm",
      "username": "acme_sales"
    }
  ],
  "available_accounts": [
    {
      "id": "Rb7YsK3dQp",
      "username": "acme_founder"
    }
  ],
  "daily_scoring_limit": 3300
}

ペルソナの共有を取得

GET/v1/personas/:persona_id/sharingreadスコープMCPget_persona_sharing

ペルソナを共有しているオーナーのXアカウントと、ほかに共有できるXアカウントを返します。

パスパラメーター

  • persona_idstring必須
    ペルソナのID。

戻り値

ペルソナ共有オブジェクト。

エラー

  • 404resource_missing
    キーのアカウントに、このIDのペルソナはありません。
GET/v1/personas/:persona_id/sharing
curl https://gemlead.ai/api/v1/personas/lvWBPnytpS/sharing \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
レスポンス200
{
  "object": "persona_sharing",
  "persona_id": "lvWBPnytpS",
  "home_account": {
    "id": "a9PzK2vRtM",
    "username": "acme"
  },
  "shared_with": [
    {
      "id": "Hq4TnW8cLm",
      "username": "acme_sales"
    }
  ],
  "available_accounts": [
    {
      "id": "Rb7YsK3dQp",
      "username": "acme_founder"
    }
  ],
  "daily_scoring_limit": 3300
}

ペルソナの共有を更新

PUT/v1/personas/:persona_id/sharingwriteスコープMCPupdate_persona_sharing

ペルソナを共有するオーナーのほかのXアカウントを、グループ内のどのXアカウントからでも設定します。アプリの共有先と同じ操作です。リスト全体を送り、共有をやめるときは空のリストを送ります。daily_scoring_limitはグループの大きさに合わせて変わり、Xアカウントごとのペースは同じです。この操作はオーナーのキーでしかできません。

パスパラメーター

  • persona_idstring必須
    ペルソナのID。

ボディパラメーター

  • account_idsstringsの配列必須
    ペルソナを共有する、オーナーのほかのすべてのXアカウント。最大20件です。作成元のXアカウントは常にペルソナを持ち続けます。

戻り値

更新されたペルソナ共有オブジェクト。

エラー

  • 400parameter_missing
    必須パラメーターがありません。paramにその名前が入ります。
  • 400parameter_invalid
    APIが受け付けない値のパラメーターがあります。paramにその名前が入ります。
  • 400parameter_unknown
    ボディに、このエンドポイントが受け付けないフィールドがあります。
  • 403forbidden
    キーはチームメンバーのものです。ペルソナを共有できるのはオーナーだけです。
  • 404resource_missing
    このIDのペルソナがないか、オーナーのものではないXアカウントが含まれています。paramにその名前が入ります。
  • 400shared_account_has_campaigns
    外そうとしているXアカウントに、まだこのペルソナのキャンペーンがあります。先に削除してください。
PUT/v1/personas/:persona_id/sharing
curl -X PUT \
  https://gemlead.ai/api/v1/personas/lvWBPnytpS/sharing \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_ids": ["Hq4TnW8cLm", "Rb7YsK3dQp"]
  }'
レスポンス200
{
  "object": "persona_sharing",
  "persona_id": "lvWBPnytpS",
  "home_account": {
    "id": "a9PzK2vRtM",
    "username": "acme"
  },
  "shared_with": [
    {
      "id": "Hq4TnW8cLm",
      "username": "acme_sales"
    },
    {
      "id": "Rb7YsK3dQp",
      "username": "acme_founder"
    }
  ],
  "available_accounts": [],
  "daily_scoring_limit": 5000
}

ペルソナの提案オブジェクト

名前と商材をもとにAIが作成したペルソナ。そのまま作成することも、編集してから作成することもできます。

属性

  • objectstring
    常にpersona_suggestionです。
  • statusstring
    AIが作成している間はpending、その後はreadyまたはerrorになります。最初のリクエストの前はnoneです。
    pendingreadyerrornone
  • persona_namestringまたはnull
    リクエストで指定された名前。
  • suggestionobjectまたはnull
    readyになると、ペルソナのdescription、keywords、competitors、avoidが入ります。ペルソナを作成のフィールドと同じです。
  • generated_atstringまたはnull
    作成された日時。ISO 8601形式です。
  • errorstringまたはnull
    statusがerrorの場合の、エラーの内容。
ペルソナの提案オブジェクト
{
  "object": "persona_suggestion",
  "status": "ready",
  "persona_name": "Tipsters",
  "suggestion": {
    "description": "Sports and trading tipsters who sell picks or signals to a paying community on Discord or Telegram.",
    "keywords": ["tipster", "vip picks", "trading signals"],
    "competitors": ["Patreon", "Whop"],
    "avoid": ["betting brands", "sports media"]
  },
  "generated_at": "2026-11-06T07:45:12.904Z",
  "error": null
}

ペルソナを提案

POST/v1/persona_suggestionswriteスコープMCPsuggest_persona

名前と販売している商材をもとにAIにペルソナを作成させるか、説明を書き直させます。数秒かかるため、レスポンスはpendingになります。結果はペルソナの提案を取得で読み取ります。

ボディパラメーター

  • persona_namestring必須
    作成するペルソナ。Ghostwritersのように1語から3語で指定します。
  • websitestring
    あなたの商材のウェブサイト。デフォルトはXプロフィールに記載のウェブサイトです。
  • briefstring
    何を誰に販売しているかを、あなたの言葉で説明します。1 000文字までです。
  • current_descriptionstring
    instructionとともに指定する、書き直す説明文。
  • instructionstring
    current_descriptionをどう変えるか。shorterやonly US agenciesなどで、2 000文字までです。

戻り値

statusがpendingのペルソナの提案オブジェクト。

エラー

  • 400parameter_missing
    必須パラメーターがありません。paramにその名前が入ります。
  • 400parameter_invalid
    APIが受け付けない値のパラメーターがあります。paramにその名前が入ります。
  • 400parameter_unknown
    ボディに、このエンドポイントが受け付けないフィールドがあります。
  • 502upstream_unavailable
    XまたはGemleadのサービスが応答しませんでした。何も変更されていないので、1分後にもう一度お試しください。
POST/v1/persona_suggestions
curl -X POST https://gemlead.ai/api/v1/persona_suggestions \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "persona_name": "Tipsters",
    "brief": "A checkout for paid Discord and Telegram groups."
  }'
レスポンス202
{
  "object": "persona_suggestion",
  "status": "pending",
  "persona_name": "Tipsters",
  "suggestion": null,
  "generated_at": null,
  "error": null
}

ペルソナの提案を取得

GET/v1/persona_suggestions/latestreadスコープMCPget_persona_suggestion

アカウントの最新のペルソナの提案を返します。pendingの間は、数秒ごとに再度リクエストしてください。

戻り値

ペルソナの提案オブジェクト。

GET/v1/persona_suggestions/latest
curl https://gemlead.ai/api/v1/persona_suggestions/latest \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
レスポンス200
{
  "object": "persona_suggestion",
  "status": "ready",
  "persona_name": "Tipsters",
  "suggestion": {
    "description": "Sports and trading tipsters who sell picks or signals to a paying community on Discord or Telegram.",
    "keywords": ["tipster", "vip picks", "trading signals"],
    "competitors": ["Patreon", "Whop"],
    "avoid": ["betting brands", "sports media"]
  },
  "generated_at": "2026-11-06T07:45:12.904Z",
  "error": null
}
Gemleadの最新情報を
メールで直接お届けします。
登録
登録すると、プライバシーポリシーに同意し、当社からのお知らせの受信を承諾したものとみなされます。
Gemlead
製品
始める
ログイン
こんな方に
AIエージェント
機能
料金
アフィリエイト
FAQ
機能
24時間、買い手を発見ホットリード優先返信率60%超え心を読むDM全DMをひとつにAIクローザー限界なくスケールAPI・MCP・WebhookGemleadに質問
リソース
ホームAPIブログ
法的情報
利用規約
プライバシー
© 2026 Gemlead, Inc. 無断転載を禁じます。
日本語