トップ 料金 ドキュメント FAQ
ドキュメントを検索 ⌘K
無料で始める → →
ドキュメント / はじめに

トレンドXサポート API ドキュメント

トレンドXサポート は X (Twitter) の自動化 API（日本一安い） です。月額固定なし、クレジット制で使った分だけ。本ドキュメントですべてのエンドポイントの使い方を確認できます。

まだアカウントをお持ちでない方

無料でサインアップすると 100 クレジットを差し上げます。クレジットカード不要・30 秒で利用開始できます。

クイックスタート

4 ステップで最初の API リクエストを送信できます。読み取り系（プロフィール取得など）はステップ 3 まででOK、書き込み系（投稿・いいね等）はステップ 2 で X 認証が必要です。

1. トレンドXサポート の API キーを取得

ダッシュボードの API キー管理 ページから本番用キー（sk_live_xxx）またはテスト用キー（sk_test_xxx）を発行します。

2. X の auth_token を準備（書き込み系を使う場合のみ）

投稿・いいね・リポスト・DM・フォロー・ブックマーク等の操作には、X アカウントの auth_token が必要です。auth_token はどこで取得しても同じ値なので、以下のいずれかで取得できます：

# X ログインで auth_token を取得 curl -X POST https://api.trend-x.pro/v1/x_login \ -H "Authorization: Bearer sk_live_xxx" \ -H "Content-Type: application/json" \ -d '{"username":"myaccount","password":"mypassword","email":"me@example.com"}'
// X ログインで auth_token を取得 const res = await fetch("https://api.trend-x.pro/v1/x_login", { method: "POST", headers: { Authorization: "Bearer sk_live_xxx", "Content-Type": "application/json" }, body: JSON.stringify({ username: "myaccount", password: "mypassword", email: "me@example.com" }) }); const { auth_token } = await res.json();
# X ログインで auth_token を取得 import requests res = requests.post( "https://api.trend-x.pro/v1/x_login", headers={"Authorization": "Bearer sk_live_xxx"}, json={ "username": "myaccount", "password": "mypassword", "email": "me@example.com" } ) auth_token = res.json()["auth_token"]

3. 認証ヘッダーをつけてリクエスト

すべてのリクエストに Authorization: Bearer sk_xxx ヘッダーを付けます。書き込み系には body に auth_token を含めます。

# 読み取り系：プロフィール取得（X 認証不要） curl https://api.trend-x.pro/v1/profiles/elonmusk \ -H "Authorization: Bearer sk_live_xxx" # 書き込み系：いいねする（X 認証が必要） curl -X POST https://api.trend-x.pro/v1/posts/post_8a4f2c1d/likes \ -H "Authorization: Bearer sk_live_xxx" \ -H "Content-Type: application/json" \ -d '{"auth_token":"7b3f9c1e2d8a4f6b9c0e..."}'
// 読み取り系：プロフィール取得 const res = await fetch("https://api.trend-x.pro/v1/profiles/elonmusk", { headers: { Authorization: "Bearer sk_live_xxx" } }); // 書き込み系：いいねする await fetch("https://api.trend-x.pro/v1/posts/post_8a4f2c1d/likes", { method: "POST", headers: { Authorization: "Bearer sk_live_xxx", "Content-Type": "application/json" }, body: JSON.stringify({ auth_token: "7b3f9c1e..." }) });
# 読み取り系：プロフィール取得 import requests res = requests.get( "https://api.trend-x.pro/v1/profiles/elonmusk", headers={"Authorization": "Bearer sk_live_xxx"} ) # 書き込み系：いいねする requests.post( "https://api.trend-x.pro/v1/posts/post_8a4f2c1d/likes", headers={"Authorization": "Bearer sk_live_xxx"}, json={"auth_token": "7b3f9c1e..."} )

4. レスポンスを受け取る

すべてのレスポンスは JSON 形式で返されます。

{ "object": "profile", "id": "prof_8a4f2c1d4e9b3a7f", "handle": "elonmusk", "name": "Elon Musk", "description": "Mars, Cars, Chips, Starships", "verified": true, "follower_count": 220841523, "following_count": 872, "post_count": 79241, "created_at": "2009-06-02T20:12:29Z", "avatar_url": "https://cdn.trend-x.pro/avatars/elonmusk.jpg" }

認証

トレンドXサポート API はすべてのリクエストで Bearer トークン認証を使用します。HTTPS 経由でのみアクセス可能です。

GET https://api.trend-x.pro/v1/...
ヘッダー
型
説明
Authorization
string必須
Bearer sk_live_xxx または Bearer sk_test_xxx の形式で API キーを指定します。
X-トレンドXサポート-Version
string
使用する API バージョン（例: 2026-05-15）。省略時は最新版が使用されます。
API キーは絶対に公開しないでください

API キーをクライアントサイドの JavaScript やパブリックリポジトリに含めないでください。漏洩した場合はダッシュボードからすぐに無効化できます。

クレジット消費

各リクエストは トレンドXサポート クレジットを消費します。プランで購入したクレジットから差し引かれます。

カテゴリ
消費
例
読み取り
1 クレジット
プロフィール取得、投稿取得、検索、フォロワー一覧、トレンド取得など
書き込み
1 クレジット
投稿、いいね、リポスト、フォロー、ブックマーク追加など
DM 送信
2 クレジット
ダイレクトメッセージの送信は他の操作よりコストが高くなります

レスポンスヘッダー X-トレンドXサポート-Credits-Used と X-トレンドXサポート-Credits-Remaining で残高を確認できます。

エラー

トレンドXサポート API は標準的な HTTP ステータスコードを返します。

コード
名前
説明
200
OK
リクエストが正常に処理されました
400
Bad Request
リクエストの形式やパラメータが不正です
401
Unauthorized
API キーが無効、または欠落しています
402
Payment Required
クレジット残高が不足しています
404
Not Found
指定したリソース（プロフィール / 投稿など）が存在しません
500
Server Error
サーバー側で予期しないエラーが発生しました。お問い合わせください

エラーレスポンスの構造

{ "error": { "type": "invalid_request", "code": "profile_not_found", "message": "Profile with handle 'xxx' does not exist.", "request_id": "req_8b3f1d4e7a9c2f5e" } }

ページネーション

一覧系のエンドポイント（フォロワー、投稿、検索結果など）はカーソルベースのページネーションを使用します。

{ "object": "list", "data": [ /* ... 20 items ... */ ], "has_more": true, "next_cursor": "cur_8b3f1d4e7a9c2f5e" }

次のページを取得するには ?cursor=cur_xxx パラメータを追加します。

レート制限

トレンドXサポート ではすべてのプランでリクエスト数の制限はありません。1 分間に何回でも、1 秒間に何回でもリクエスト可能です。

大量リクエスト時は同一 IP の DDoS 防御によって自動的に短時間制限がかかる場合がありますが、通常の API 利用では問題ありません。

API リファレンス 全 51 機能

カテゴリーごとに整理された、トレンドXサポート で利用可能なすべての API 機能の詳細です。各エンドポイントには「マークダウンをコピー」ボタンがあり、ChatGPT・Claude などの AI に貼り付けて実装相談ができます。書き込み系には独自プロキシを指定できる proxy パラメータが用意されており、100% に近い成功率を実現します。

絞り込み:
🔐

X 認証

ユーザーの X アカウントにログインさせ、認証済みクッキーを発行。以降の DM 送信・投稿などの認証必須 API で使用。

ログイン認証クッキー発行2FA 対応
1 機能
POST /v1/x_login X ログイン（auth_token 取得の便利機能）
1 クレジット 📊 1 リクエスト = 1件（トークン）

X のユーザー名・パスワードから auth_token を取得する便利機能です。

auth_token はどこで取得しても同じ値なので、以下の方法でも取得できます：

① ブラウザの DevTools から：X にログイン → F12 → Application → Cookies → auth_token の値をコピー
② このエンドポイントで取得：ユーザー名・パスワードを送信して自動取得
③ 既に持っている auth_token をそのまま使用：他のツールで取得済みのものもそのまま使えます

取得した auth_token は X 側でログアウト or 無効化されない限り、ずっと使い回せます。

パラメータ

項目名
型
説明
username
string必須
X のユーザー名（@ なし）
password
string必須
X のパスワード
email
string
認証用メールアドレス。X 側で「身元確認」が要求された場合に使用されます
totp_secret
string
2要素認証が有効な場合に指定。Base32 形式の TOTP シークレット
proxy
string
独自プロキシURL（成功率向上・住居用 IP 使用時推奨）

注記

  • auth_token、ct0、twid を含む新しい認証情報を返却します。
  • メールが重要な理由： X のログインは多段階フローで、パスワード入力後に「身元確認（メール入力）」が確率的に発動します（アカウント年齢・IP の評判・ログイン履歴などで決定）。リクエスト毎に予測できないため、安全策として常にメールを指定することを推奨します。
  • 2要素認証： 2FA が有効なアカウントは totp_secret を渡すことで、6桁コードが自動生成されます。
  • プロキシ： 自身のIPアドレスからログインしたい場合や、その後の API 呼び出しと同じ IP で続けたい場合に推奨。
  • ログイン成功後、プロフィール情報も自動で取得されます。

使用例（cURL）

"cmt"># 通常ログイン（2FA なし） "kw">curl -X POST https://api.trend-x.pro/v1/x_login \ "kw">-H "Authorization: Bearer sk_live_xxx" \ "kw">-H "Content-Type: application/json" \ "kw">-d '{ "username": "myaccount", "password": "mypassword", "email": "myemail@example.com" }' "cmt"># 2FA 有効のアカウント "kw">curl -X POST https://api.trend-x.pro/v1/x_login \ "kw">-H "Authorization: Bearer sk_live_xxx" \ "kw">-H "Content-Type: application/json" \ "kw">-d '{ "username": "myaccount", "password": "mypassword", "email": "myemail@example.com", "totp_secret": "JBSWY3DPEHPK3PXP" }' "cmt"># 独自プロキシ経由ログイン "kw">curl -X POST https://api.trend-x.pro/v1/x_login \ "kw">-H "Authorization: Bearer sk_live_xxx" \ "kw">-H "Content-Type: application/json" \ "kw">-d '{ "username": "myaccount", "password": "mypassword", "email": "myemail@example.com", "proxy": "http://user:pass@host:port" }'

成功時のレスポンス (200 OK)

{ "object": "x_login", "username": "myaccount", "auth_token": "7b3f9c1e2d8a4f6b9c0e1a2d3f4b5c6e7a8b9c0d", "ct0": "9a2c4e6f8b1d3a5c7e9f0b2d4a6c8e0f", "twid": "u=1623458791034556928", "profile": { "object": "profile", "id": "prof_8a4f2c1d", "handle": "myaccount", "name": "My Account", "verified": false, "blue_verified": false, "follower_count": 18, "following_count": 33, "created_at": "2023-03-15T09:42:11Z" } }

400 — パラメータ不足

{ "error": { "type": "invalid_request", "code": "credentials_required", "message": "username、password は必須です" } }

401 — 2FA トークン必要

{ "error": { "type": "authentication_error", "code": "totp_required", "message": "2要素認証が有効です。totp_secret を指定してください" } }

500 — ログイン失敗

{ "error": { "type": "login_failed", "code": "invalid_credentials", "message": "認証情報が間違っているか、アカウントがロックされています" } }
👤

プロフィール

ユーザー情報、フォロワー、フォロー中ユーザー、ツイート一覧、リプライ、メディア投稿などをまとめて取得。

フォロワー分析競合調査インフルエンサー発掘ユーザー検索
8 機能
GET /v1/profiles/{handle} プロフィール取得 人気
1 クレジット 📊 1 リクエスト = 1件（プロフィール）

指定したハンドル名のプロフィール情報を取得します。他者を含む任意のアカウントが対象です。

パラメータ

項目名
型
説明
handle
string必須
取得対象のハンドル名（@ なし、例: elonmusk）。ID で指定する場合は /v1/profiles/id_{id} 形式

注記

  • 完全なプロフィール情報を 1 リクエストで返します（ページネーション不要）。
  • 認証情報なしで誰でも閲覧可能なプロフィール情報のみ返します（鍵アカウントの非公開情報は取得不可）。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/profiles/elonmusk \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "profile", "id": "prof_8a4f2c1d4e9b3a7f", "handle": "elonmusk", "name": "Elon Musk", "description": "Mars, Cars, Chips, Starships", "location": "", "verified": true, "blue_verified": true, "follower_count": 220841523, "following_count": 872, "post_count": 79241, "favourites_count": 4079, "media_count": 113, "can_dm": false, "created_at": "2009-06-02T20:12:29Z", "avatar_url": "https://cdn.trend-x.pro/avatars/elonmusk.jpg", "cover_url": "https://cdn.trend-x.pro/banners/elonmusk.jpg", "pinned_post_ids": [] }

404 — プロフィールが存在しません

{ "error": { "type": "not_found", "code": "profile_not_found", "message": "ハンドル名 xxx のプロフィールは存在しません" } }
GET /v1/profiles/{handle}/posts 投稿一覧取得 人気
1 クレジット 📊 1 リクエスト = 約20件

指定アカウントの投稿（リプライ・リポスト除く）を新着順に取得します。1リクエストで約 20 件返ります。

パラメータ

項目名
型
説明
handle
string必須
ハンドル名（または ID で指定する場合 id_{id}）
cursor
string
ページネーション用カーソル
limit
integer
1リクエストあたり取得件数（最大100、デフォルト20）

注記

  • 指定アカウントの「投稿」タブに表示される内容を返します（ホームフィードではなく、本人が投稿したツイートのみ）。
  • リプライ・リポストは除外されます。これらを含めたい場合は別のエンドポイントをご利用ください。
  • 各投稿には entities オブジェクトが含まれ、ハッシュタグ・URL・メンション等が構造化された形で取得できます（t.co 短縮 URL の展開済み URL も含む）。
  • 1 リクエストで約 20 件、next_cursor でページネーション。

使用例（cURL）

"kw">curl "https://api.trend-x.pro/v1/profiles/elonmusk/posts?limit=50" \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "list", "data": [ "object": "post", "id": "post_8a4f2c1d", "text": "Hello world", "author": {"handle": "elonmusk", "name": "Elon Musk"}, "like_count": 12453, "repost_count": 892, "reply_count": 451, "view_count": 230000, "created_at": "2026-05-15T08:00:00Z" ], "has_more": true, "next_cursor": "cur_8b3f1d4e7a9c2f5e" }

400 — パラメータ不足

{ "error": { "type": "invalid_request", "code": "handle_required" } }
GET /v1/profiles/{handle}/followers フォロワー一覧取得
1 クレジット 📊 1 リクエスト = 約200件

指定アカウントをフォローしているユーザーの一覧を取得します。

パラメータ

項目名
型
説明
handle
string必須
ハンドル名
cursor
string
ページネーション用カーソル

注記

  • 1 リクエストで約 200 件、next_cursor でページネーション。
  • 大規模アカウントの全フォロワー取得には多数のリクエストが必要です。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/profiles/elonmusk/followers \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "list", "data": [{"object": "profile", "id": "prof_xxx", "handle": "user1", "name": "User One"}], "has_more": true, "next_cursor": "cur_8b3f1d4e" }
GET /v1/profiles/{handle}/following フォロー中一覧取得 人気
1 クレジット 📊 1 リクエスト = 約200件

指定アカウントがフォローしているユーザーの一覧を取得します。

パラメータ

項目名
型
説明
handle
string必須
ハンドル名
cursor
string
ページネーション用カーソル

注記

  • 1 リクエストで約 200 件、next_cursor でページネーション。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/profiles/elonmusk/following \ "kw">-H "Authorization: Bearer sk_live_xxx"
GET /v1/profiles/{handle}/likes いいね履歴
1 クレジット 📊 1 リクエスト = 約20件

指定アカウントがいいねした投稿の一覧を取得します。

パラメータ

項目名
型
説明
handle
string必須
ハンドル名
cursor
string
ページネーション用カーソル

注記

  • 鍵アカウントのいいね履歴は取得できません。
  • 1 リクエストで約 20 件、next_cursor でページネーション。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/profiles/elonmusk/likes \ "kw">-H "Authorization: Bearer sk_live_xxx"
GET /v1/profiles/{handle}/media メディア取得
1 クレジット 📊 1 リクエスト = 約20件

指定アカウントが投稿した画像・動画付きツイートのみを取得します。

パラメータ

項目名
型
説明
handle
string必須
ハンドル名
cursor
string
ページネーション用カーソル

注記

  • 画像・動画・GIF が添付されたツイートのみが返されます。
  • 各メディアには トレンドXサポート の CDN 経由の URL が含まれ、高速配信されます。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/profiles/elonmusk/media \ "kw">-H "Authorization: Bearer sk_live_xxx"
GET /v1/profiles/{handle}/verified_followers 認証済みフォロワー
1 クレジット 📊 1 リクエスト = 約200件

指定アカウントの認証済み（チェックマーク付き）フォロワーのみを取得します。

パラメータ

項目名
型
説明
handle
string必須
ハンドル名
cursor
string
ページネーション用カーソル

注記

  • Twitter Blue 認証済みフォロワーが含まれます（レガシー認証も対象）。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/profiles/elonmusk/verified_followers \ "kw">-H "Authorization: Bearer sk_live_xxx"
GET /v1/profiles/{handle}/lists 所属リスト一覧
1 クレジット 📊 1 リクエスト = 約20件

指定アカウントが追加されているリストの一覧を取得します。

パラメータ

項目名
型
説明
handle
string必須
ハンドル名

注記

  • 公開リストのみ返されます。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/profiles/elonmusk/lists \ "kw">-H "Authorization: Bearer sk_live_xxx"
📝

投稿取得

個別ツイート、ツイートの詳細、リプライ、引用 RT、いいねしたユーザー一覧などを取得。

コンテンツ分析バイラル投稿追跡エンゲージメント計測
5 機能
GET /v1/posts/{id} 投稿取得
1 クレジット 📊 1 リクエスト = 1件（投稿）

投稿IDから単一の投稿を取得します。引用元、添付メディア、リプライ情報、エンゲージメント全般を含みます。

パラメータ

項目名
型
説明
id
string必須
投稿ID（例: post_8a4f2c1d）

注記

  • 完全な著者情報、添付メディア、エンゲージメント数（いいね・リポスト・リプライ・引用・閲覧数・ブックマーク数）を 1 リクエストで取得できます。
  • 引用元の投稿（quoted_post）も含まれます。
  • リプライの場合は in_reply_to_post_id および conversation_id が設定されます。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/posts/post_8a4f2c1d \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "post", "id": "post_8a4f2c1d", "url": "https://x.com/elonmusk/status/2019264360682778716", "text": "Hello world", "lang": "en", "source": "Twitter for iPhone", "author": {"object": "profile", "handle": "elonmusk", "name": "Elon Musk", "id": "prof_xxx"}, "like_count": 3676, "repost_count": 136, "reply_count": 396, "quote_count": 11, "view_count": 298555, "bookmark_count": 121, "is_reply": false, "in_reply_to_post_id": null, "conversation_id": "post_xxx", "media": [], "quoted_post": null, "created_at": "2026-02-05T04:18:34Z" }

404 — 投稿が存在しません

{ "error": { "type": "not_found", "code": "post_not_found" } }
GET /v1/posts/{id}/replies リプライ取得
1 クレジット 📊 1 リクエスト = 約20件

指定投稿に対するリプライ（返信）の一覧を取得します。

パラメータ

項目名
型
説明
id
string必須
投稿ID
cursor
string
ページネーション用カーソル

注記

  • 指定投稿への直接のリプライのみ返されます（リプライへのリプライは含まれません）。
  • next_cursor でページネーション。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/posts/post_8a4f2c1d/replies \ "kw">-H "Authorization: Bearer sk_live_xxx"
GET /v1/posts/{id}/quotes 引用ツイート取得
1 クレジット 📊 1 リクエスト = 約20件

指定投稿を引用した投稿の一覧を取得します。

パラメータ

項目名
型
説明
id
string必須
投稿ID
cursor
string
ページネーション用カーソル

注記

  • 指定投稿を引用したツイートを新着順で返します。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/posts/post_8a4f2c1d/quotes \ "kw">-H "Authorization: Bearer sk_live_xxx"
GET /v1/posts/{id}/reposters リポストした人
1 クレジット 📊 1 リクエスト = 約20件

指定投稿をリポストしたユーザーの一覧を取得します。

パラメータ

項目名
型
説明
id
string必須
投稿ID
cursor
string
ページネーション用カーソル

注記

  • リポストしたユーザーのプロフィール情報を返します。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/posts/post_8a4f2c1d/reposters \ "kw">-H "Authorization: Bearer sk_live_xxx"
GET /v1/posts/{id}/likers いいねした人
1 クレジット 📊 1 リクエスト = 約20件

指定投稿にいいねしたユーザーの一覧を取得します。

パラメータ

項目名
型
説明
id
string必須
投稿ID
cursor
string
ページネーション用カーソル

注記

  • いいねしたユーザーのプロフィール情報を返します。
  • X の制約により、非常に多くのいいねがついた投稿では一部しか取得できない場合があります。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/posts/post_8a4f2c1d/likers \ "kw">-H "Authorization: Bearer sk_live_xxx"
💬

投稿・アクション

投稿の作成・削除、いいね、リツイート、引用 RT などのアクションを認証ユーザーで実行。

自動投稿いいねブースト一括 RTコンテンツ削除
6 機能
POST /v1/posts 投稿作成 重要
2 クレジット 📊 1 リクエスト = 1件（作成された投稿）

新規ツイートを投稿します。テキスト、画像、動画（base64・URL・既存メディアID）、引用、リプライ、独自プロキシ経由に対応。100% 成功率には独自プロキシ推奨。auth_token は X ログイン で取得します。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
text
string必須
投稿本文（最大280字、認証ユーザーは長文も可）
reply_to
string
リプライ先の投稿ID
quote_url
string
引用元のURL（例: https://x.com/username/status/123、高速）
quote_of
string
引用元の投稿ID（URL に自動変換）
proxy
string
独自プロキシURL（例: http://user:pass@host:port）。クリーンIPから投稿
media_ids
array
アップロード済みメディアIDの配列（最大4件）
media_urls
array
メディアの URL 配列（サーバーが自動取得・アップロード）
media
array
base64エンコード済みメディアオブジェクトの配列
media[].data
string必須*
base64エンコードされたファイル内容（media 使用時必須）
media[].type
string必須*
MIMEタイプ（例: image/png、video/mp4）

注記

  • 認証トークン所有者として投稿が作成されます。
  • プロキシ： サーバーの IP ではなく独自プロキシ経由で投稿することで、成功率が向上します。
  • 引用ツイート： quote_url（URL指定・高速）または quote_of（ID 指定・自動で URL に解決）。
  • メディア添付の 3 方式（1 つのリクエスト内で混在可能）：
  •   media_ids — 既にアップロード済みのメディア ID を指定する場合
  •   media_urls — 画像/動画の URL を渡すと、トレンドXサポート が取得して自動でアップロード
  •   media — base64 エンコード済みのファイルをインラインで送信
  • 動画アップロード： トレンドXサポート 側でチャンク単位のアップロード（INIT → APPEND → FINALIZE）を自動処理し、X 側の処理完了まで待機します。
  • X 側で投稿が拒否された場合は 502 エラーを返します。

メディア制限

添付するメディアの種類と上限：

種類
枚数
制限
画像
最大4枚
5MB（JPEG/PNG）/ 15MB（GIF）。
対応形式: JPEG, PNG, GIF, WEBP
GIF
1枚
5MB（Web）/ 15MB（モバイル）
動画 (無料)
1動画
最大 2分20秒、512MB、1080p、MP4/MOV
動画 (Premium)
1動画
最大 約3時間、8GB、1080p（≤2h）/ 720p（2-4h）
動画 (Premium+)
1動画
最大 4時間、16GB、Premium と同等

使用例（cURL）

"cmt"># テキストのみ "kw">curl -X POST https://api.trend-x.pro/v1/posts \ "kw">-H "Authorization: Bearer sk_live_xxx" \ "kw">-H "Content-Type: application/json" \ "kw">-d '{ "auth_token": "7b3f9c1e2d8a4f6b9c0e1a2d3f4b5c6e", "text": "Hello world!" }' "cmt"># メディアURL付き "kw">curl -X POST https://api.trend-x.pro/v1/posts \ "kw">-H "Authorization: Bearer sk_live_xxx" \ "kw">-H "Content-Type: application/json" \ "kw">-d '{ "auth_token": "7b3f9c1e2d8a4f6b9c0e1a2d3f4b5c6e", "text": "Check this", "media_urls": ["https://example.com/photo.jpg"] }' "cmt"># 引用ツイート "kw">curl -X POST https://api.trend-x.pro/v1/posts \ "kw">-H "Authorization: Bearer sk_live_xxx" \ "kw">-H "Content-Type: application/json" \ "kw">-d '{ "auth_token": "7b3f9c1e2d8a4f6b9c0e1a2d3f4b5c6e", "text": "Interesting!", "quote_url": "https://x.com/elonmusk/status/2019264360682778716" }' "cmt"># 独自プロキシ経由 "kw">curl -X POST https://api.trend-x.pro/v1/posts \ "kw">-H "Authorization: Bearer sk_live_xxx" \ "kw">-H "Content-Type: application/json" \ "kw">-d '{ "auth_token": "7b3f9c1e2d8a4f6b9c0e1a2d3f4b5c6e", "text": "From my IP", "proxy": "http://user:pass@host:port" }'

成功時のレスポンス (200 OK)

{ "object": "post", "id": "post_8a4f2c1d4e9b3a7f", "text": "Hello world!", "created_at": "2026-05-15T10:30:00Z" }

400 — 本文が空

{ "error": { "type": "invalid_request", "code": "text_required", "message": "text フィールドは必須です" } }

401 — 認証エラー

{ "error": { "type": "authentication_error", "code": "invalid_api_key" } }

502 — X側で投稿確認できず

{ "error": { "type": "upstream_error", "code": "post_not_confirmed", "message": "X 側で投稿の完了が確認できませんでした。proxy パラメータの使用で改善する可能性があります" } }
DELETE /v1/posts/{id} 投稿削除
1 クレジット 📊 1 リクエスト = 操作結果のみ

自身の投稿を削除します。他者の投稿は削除できません。auth_token の所有者の投稿のみ削除可能。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
id
string必須
削除対象の投稿ID

注記

  • 認証トークン所有者の投稿のみ削除可能です。他者の投稿を削除しようとすると 403 エラーを返します。
  • 削除は不可逆です。実行前に確認してください。

使用例（cURL）

"kw">curl -X DELETE https://api.trend-x.pro/v1/posts/post_8a4f2c1d \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "post", "id": "post_8a4f2c1d", "deleted": true }

403 — 他者の投稿は削除不可

{ "error": { "type": "permission_denied", "code": "not_post_owner" } }
POST /v1/posts/{id}/likes いいねする
1 クレジット 📊 1 リクエスト = 操作結果のみ

指定投稿にいいねをつけます。auth_token の所有者としていいねが実行されます。X 側で確認できない場合は 502 を返します。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
id
string必須
投稿ID
proxy
string
独自プロキシURL（成功率向上）

注記

  • 認証トークン所有者のいいねとして実行されます。
  • X 側で完了確認できない場合は 502 エラーを返します。proxy パラメータの使用で改善する可能性があります。
  • 既にいいね済みの投稿に対しても成功を返します（冪等）。

使用例（cURL）

"kw">curl -X POST https://api.trend-x.pro/v1/posts/post_8a4f2c1d/likes \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "like", "post_id": "post_8a4f2c1d", "liked": true, "created_at": "2026-05-15T10:30:00Z" }

400 — パラメータ不足

{ "error": { "type": "invalid_request", "code": "post_id_required" } }

401 — 認証エラー

{ "error": { "type": "authentication_error", "code": "invalid_api_key" } }

502 — X側でいいね確認できず

{ "error": { "type": "upstream_error", "code": "like_not_confirmed", "message": "X 側でいいねの完了が確認できませんでした" } }
DELETE /v1/posts/{id}/likes いいね解除
1 クレジット 📊 1 リクエスト = 操作結果のみ

指定投稿への自分のいいねを解除します。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
id
string必須
投稿ID
proxy
string
独自プロキシURL

注記

  • 認証トークン所有者のいいねのみ解除できます。
  • X 側で完了確認できない場合は 502 エラーを返します。

使用例（cURL）

"kw">curl -X DELETE https://api.trend-x.pro/v1/posts/post_8a4f2c1d/likes \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "like", "post_id": "post_8a4f2c1d", "liked": false }

502 — X側で解除確認できず

{ "error": { "type": "upstream_error", "code": "unlike_not_confirmed" } }
POST /v1/posts/{id}/reposts リポストする
1 クレジット 📊 1 リクエスト = 操作結果のみ

指定投稿をリポスト（旧リツイート）します。auth_token の所有者としてリポストが実行されます。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
id
string必須
投稿ID
proxy
string
独自プロキシURL

注記

  • 認証トークン所有者のリポストとして実行されます。
  • X 側で完了確認できない場合は 502 エラーを返します。
  • 新しく作成されたリポストの ID は repost_id として返されます。

使用例（cURL）

"kw">curl -X POST https://api.trend-x.pro/v1/posts/post_8a4f2c1d/reposts \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "repost", "original_post_id": "post_8a4f2c1d", "repost_id": "post_9b5d3e4f", "reposted": true }

400 — パラメータ不足

{ "error": { "type": "invalid_request", "code": "post_id_required" } }

502 — X側でリポスト確認できず

{ "error": { "type": "upstream_error", "code": "repost_not_confirmed" } }
DELETE /v1/posts/{id}/reposts リポスト解除
1 クレジット 📊 1 リクエスト = 操作結果のみ

指定投稿への自分のリポストを解除します。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
id
string必須
投稿ID
proxy
string
独自プロキシURL

注記

  • 認証トークン所有者のリポストのみ解除できます。

使用例（cURL）

"kw">curl -X DELETE https://api.trend-x.pro/v1/posts/post_8a4f2c1d/reposts \ "kw">-H "Authorization: Bearer sk_live_xxx"
👥

フォロー操作

ユーザーをフォロー / アンフォロー。認証されたユーザーアカウントで実行。

フォロワー獲得自動化フォロー整理
2 機能
POST /v1/profiles/{handle}/follows フォローする
1 クレジット 📊 1 リクエスト = 操作結果のみ

指定ユーザーをフォローします。auth_token の所有者としてフォローが実行されます。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
handle
string必須
フォロー対象のハンドル名
proxy
string
独自プロキシURL

注記

  • 認証トークン所有者としてフォローが実行されます。
  • 鍵アカウントの場合はフォローリクエストが送信されます（即時フォロー成立しない）。

使用例（cURL）

"kw">curl -X POST https://api.trend-x.pro/v1/profiles/elonmusk/follows \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "follow", "handle": "elonmusk", "following": true, "created_at": "2026-05-15T10:30:00Z" }

502 — X側でフォロー確認できず

{ "error": { "type": "upstream_error", "code": "follow_not_confirmed" } }
DELETE /v1/profiles/{handle}/follows アンフォロー
1 クレジット 📊 1 リクエスト = 操作結果のみ

指定ユーザーのフォローを解除します。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
handle
string必須
アンフォロー対象のハンドル名
proxy
string
独自プロキシURL

注記

  • 認証トークン所有者のフォローのみ解除できます。

使用例（cURL）

"kw">curl -X DELETE https://api.trend-x.pro/v1/profiles/elonmusk/follows \ "kw">-H "Authorization: Bearer sk_live_xxx"
🔖

ブックマーク

投稿のブックマーク追加・削除、ブックマーク一覧の取得。

コンテンツ収集保存リスト管理
3 機能
GET /v1/account/bookmarks ブックマーク一覧取得 NEW
1 クレジット 📊 1 リクエスト = 約20件

auth_token 所有者のブックマーク一覧を取得します。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
cursor
string
次のページを取得するカーソル
limit
integer
1リクエストあたり取得件数（最大100、デフォルト20）

注記

  • 認証トークン所有者のブックマーク一覧を新着順で返します。
  • 1 リクエストで約 20 件、next_cursor でページネーション。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/account/bookmarks \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "list", "data": [{"object": "bookmark", "post_id": "post_8a4f2c1d", "bookmarked_at": "2026-05-15T08:00:00Z"}], "has_more": false }
POST /v1/posts/{id}/bookmarks ブックマーク追加 NEW
1 クレジット 📊 1 リクエスト = 操作結果のみ

指定した投稿を auth_token 所有者のブックマークに追加します。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
id
string必須
ブックマーク対象の投稿ID
proxy
string
独自プロキシURL

注記

  • 認証トークン所有者のブックマークとして追加されます。
  • 既にブックマーク済みの投稿に対しても成功を返します（冪等）。

使用例（cURL）

"kw">curl -X POST https://api.trend-x.pro/v1/posts/post_8a4f2c1d/bookmarks \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "bookmark", "post_id": "post_8a4f2c1d", "bookmarked": true, "created_at": "2026-05-15T10:30:00Z" }

502 — X側でブックマーク確認できず

{ "error": { "type": "upstream_error", "code": "bookmark_not_confirmed" } }
DELETE /v1/posts/{id}/bookmarks ブックマーク削除 NEW
1 クレジット 📊 1 リクエスト = 操作結果のみ

指定した投稿をブックマークから削除します。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
id
string必須
ブックマーク解除対象の投稿ID
proxy
string
独自プロキシURL

注記

  • 認証トークン所有者のブックマークのみ解除できます。

使用例（cURL）

"kw">curl -X DELETE https://api.trend-x.pro/v1/posts/post_8a4f2c1d/bookmarks \ "kw">-H "Authorization: Bearer sk_live_xxx"
✉️

ダイレクトメッセージ

DM の送信、DM 受信履歴の取得。認証済みアカウントで実行。

カスタマーサポート営業 DM 配信通知 Bot
2 機能
GET /v1/dms/{conversation_id} DM 会話取得
1 クレジット 📊 1 リクエスト = 約50件

auth_token 所有者の指定会話スレッドのメッセージ一覧を取得します。1リクエストで約 50 件返ります。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
conversation_id
string必須
会話ID（例: dm_8a4f2c1d）
cursor
string
ページネーション用カーソル

注記

  • 認証トークン所有者が参加している会話のメッセージを取得します。
  • 1 リクエストで約 50 件、cursor でページネーション。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/dms/dm_8a4f2c1d \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "list", "data": [ {"object": "message", "id": "msg_xxx", "text": "Hello", "from": "prof_xxx", "created_at": "2026-05-15T08:00:00Z"} ], "has_more": false }
POST /v1/dms DM 送信
2 クレジット 📊 1 リクエスト = 操作結果のみ

指定ユーザーにダイレクトメッセージを送信します。受信側があなたを受け入れる設定の場合のみ送信可能。auth_token 所有者から送信されます。

パラメータ

項目名
型
説明
auth_token
string必須
X の認証トークン（cookie の auth_token、または X ログイン API で取得）
recipient_id
string必須*
送信先のプロフィールID または ハンドル名（どちらか必須）
text
string必須
メッセージ本文（最大10,000字）
media_id
string
添付メディアID

注記

  • recipient_id または recipient_username のどちらかを指定してください。
  • recipient_username（ハンドル名）を指定した場合、内部で自動的にプロフィール ID に解決されます。
  • 送信先が DM の受信設定を制限している場合は 403 エラーを返します。
  • DM 送信は他の操作より上流コストが高いため、2 クレジット消費します。

使用例（cURL）

"cmt"># ハンドル名で送信 "kw">curl -X POST https://api.trend-x.pro/v1/dms \ "kw">-H "Authorization: Bearer sk_live_xxx" \ "kw">-H "Content-Type: application/json" \ "kw">-d '{"recipient_id":"elonmusk","text":"Hi!"}' "cmt"># プロフィールIDで送信 "kw">curl -X POST https://api.trend-x.pro/v1/dms \ "kw">-H "Authorization: Bearer sk_live_xxx" \ "kw">-H "Content-Type: application/json" \ "kw">-d '{"recipient_id":"prof_8a4f2c1d","text":"Hi!"}'

成功時のレスポンス (200 OK)

{ "object": "message", "id": "msg_8a4f2c1d4e9b3a7f", "conversation_id": "dm_8a4f2c1d", "from": "prof_xxx", "to": "prof_yyy", "text": "Hi!", "delivered": true, "created_at": "2026-05-15T10:30:00Z" }

400 — 送信先未指定

{ "error": { "type": "invalid_request", "code": "recipient_required", "message": "recipient_id（ハンドル名 or プロフィールID）が必要です" } }

403 — DM受信拒否設定

{ "error": { "type": "permission_denied", "code": "dm_not_allowed", "message": "送信先がDMを受け入れていません" } }
🎙️

スペース

X スペース（音声配信）の情報、参加者リスト、状態を取得。

スペースイベント分析リアルタイム視聴者数
2 機能
GET /v1/spaces/{id} スペース取得
1 クレジット 📊 1 リクエスト = 1件（スペース情報）

指定スペース（音声配信）の情報を取得します。

パラメータ

項目名
型
説明
id
string必須
スペースID

注記

  • スペースのメタデータ（タイトル、ホスト、状態、開始時刻、参加者数等）を返します。
  • 終了済みスペースの録音 URL も取得可能（録音が公開されている場合）。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/spaces/spc_8a4f2c1d \ "kw">-H "Authorization: Bearer sk_live_xxx"
GET /v1/spaces/{id}/participants 参加者取得
1 クレジット 📊 1 リクエスト = 約20件

指定スペースの参加者（ホスト・スピーカー・リスナー）一覧を取得します。

パラメータ

項目名
型
説明
id
string必須
スペースID
role
string
host, speaker, listener で絞り込み

注記

  • ホスト・スピーカー・リスナーを区別して取得可能。
  • role パラメータで絞り込み。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/spaces/spc_8a4f2c1d/participants \ "kw">-H "Authorization: Bearer sk_live_xxx"
📋

リスト

ユーザーリストの作成・編集、メンバーの追加・削除、リストの投稿取得。

グループ管理コンテンツキュレーション社員リスト
3 機能
GET /v1/lists/{id} リスト取得
1 クレジット 📊 1 リクエスト = 1件（リスト情報）

ユーザーリストのメタデータ（名前、説明、メンバー数）を取得します。

パラメータ

項目名
型
説明
id
string必須
リストID

注記

  • リストのメタデータ（名前・説明・メンバー数・フォロワー数・作成者）を返します。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/lists/lst_8a4f2c1d \ "kw">-H "Authorization: Bearer sk_live_xxx"
GET /v1/lists/{id}/members リストメンバー
1 クレジット 📊 1 リクエスト = 約20件

指定リストに含まれるユーザー一覧を取得します。

パラメータ

項目名
型
説明
id
string必須
リストID
cursor
string
ページネーション用カーソル

注記

  • リストに含まれるメンバー（プロフィール情報付き）を返します。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/lists/lst_8a4f2c1d/members \ "kw">-H "Authorization: Bearer sk_live_xxx"
GET /v1/lists/{id}/posts リストタイムライン
1 クレジット 📊 1 リクエスト = 約20件

指定リストのメンバーが投稿した最新ツイートのタイムラインを取得します。

パラメータ

項目名
型
説明
id
string必須
リストID
cursor
string
ページネーション用カーソル

注記

  • リストメンバーが投稿した最新ツイートを時系列で返します。
  • 1 リクエストで約 20 件、cursor でページネーション。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/lists/lst_8a4f2c1d/posts \ "kw">-H "Authorization: Bearer sk_live_xxx"
🌐

コミュニティ

X コミュニティの情報、メンバー、投稿を取得。

ニッチ層リーチコミュニティマーケ
2 機能
GET /v1/communities/{id} コミュニティ取得
1 クレジット 📊 1 リクエスト = 1件（コミュニティ情報）

コミュニティのメタデータ（名前、説明、メンバー数、ルール）を取得します。

パラメータ

項目名
型
説明
id
string必須
コミュニティID

注記

  • コミュニティのメタデータ（名前、説明、メンバー数、ルール、管理者）を返します。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/communities/cmt_8a4f2c1d \ "kw">-H "Authorization: Bearer sk_live_xxx"
GET /v1/communities/{id}/posts コミュニティ投稿
1 クレジット 📊 1 リクエスト = 約20件

指定コミュニティ内の投稿タイムラインを取得します。

パラメータ

項目名
型
説明
id
string必須
コミュニティID
cursor
string
ページネーション用カーソル

注記

  • コミュニティ内の投稿タイムラインを取得します。
  • 1 リクエストで約 20 件、cursor でページネーション。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/communities/cmt_8a4f2c1d/posts \ "kw">-H "Authorization: Bearer sk_live_xxx"
⚡

Webhook

リアルタイムイベント通知。新規ツイート、メンション、DM などをサーバーに即時 POST。

即時通知 Botリアルタイムダッシュボード自動応答アラート
6 機能
POST /v1/webhooks Webhook 作成
1 クレジット 📊 1 リクエスト = 1件（Webhook）

イベント通知用の Webhook エンドポイントを登録します。指定 URL に対して HTTP POST で通知が送られます。

パラメータ

項目名
型
説明
url
string必須
通知先 URL（HTTPS 必須）
events
array必須
購読イベント（例: ["trend.entered", "post.created"]）
secret
string
署名検証用シークレット（HMAC-SHA256）

注記

  • 登録した URL に対し、購読イベント発生時に HTTP POST で通知が送信されます。
  • 署名検証： secret を指定すると、各通知のヘッダー X-トレンドXサポート-Signature に HMAC-SHA256 署名が付与されます。受信側で検証することでなりすましを防げます。
  • 購読可能イベント：
  •   trend.entered — 指定キーワードがトレンド入り
  •   trend.exited — 指定キーワードがトレンド離脱
  •   post.created — 指定アカウントの新規投稿
  •   post.mentioned — 指定アカウントがメンションされた
  •   follower.added — 指定アカウントに新規フォロワー
  • 通知の再送：失敗時は指数バックオフで最大 3 回まで自動再送されます。

使用例（cURL）

"kw">curl -X POST https://api.trend-x.pro/v1/webhooks \ "kw">-H "Authorization: Bearer sk_live_xxx" \ "kw">-H "Content-Type: application/json" \ "kw">-d '{"url":"https://example.com/hook","events":["trend.entered","post.created"],"secret":"whsec_xxx"}'

成功時のレスポンス (200 OK)

{ "object": "webhook", "id": "whk_8a4f2c1d", "url": "https://example.com/hook", "events": ["trend.entered", "post.created"], "secret": "whsec_xxx", "active": true, "created_at": "2026-05-15T10:30:00Z" }

400 — URL/イベント未指定

{ "error": { "type": "invalid_request", "code": "url_required" } }
GET /v1/webhooks Webhook 一覧
1 クレジット 📊 1 リクエスト = Webhook 一覧

登録済み Webhook の一覧を取得します。

パラメータ

パラメータなし

注記

  • 登録済み Webhook の一覧と各種統計（成功率、最終配信時刻）を返します。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/webhooks \ "kw">-H "Authorization: Bearer sk_live_xxx"
GET /v1/webhooks/{id} Webhook 詳細
1 クレジット 📊 1 リクエスト = 1件（Webhook 情報）

指定 Webhook の詳細情報、配信履歴、成功率を取得します。

パラメータ

項目名
型
説明
id
string必須
Webhook ID

注記

  • Webhook の詳細と配信履歴（直近 100 件）を返します。
  • 失敗した配信の HTTP ステータスコード・レスポンスボディも確認できます。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/webhooks/whk_8a4f2c1d \ "kw">-H "Authorization: Bearer sk_live_xxx"
PATCH /v1/webhooks/{id} Webhook 更新
1 クレジット 📊 1 リクエスト = 1件（更新後）

Webhook の URL や購読イベントを更新します。

パラメータ

項目名
型
説明
id
string必須
Webhook ID
url
string
新しい通知先 URL
events
array
新しい購読イベント
active
boolean
有効・無効の切り替え

注記

  • URL・購読イベント・有効状態を変更できます。
  • active: false で一時停止可能（削除せず再開できる）。

使用例（cURL）

"kw">curl -X PATCH https://api.trend-x.pro/v1/webhooks/whk_8a4f2c1d \ "kw">-H "Authorization: Bearer sk_live_xxx" \ "kw">-H "Content-Type: application/json" \ "kw">-d '{"active":false}'
DELETE /v1/webhooks/{id} Webhook 削除
1 クレジット 📊 1 リクエスト = 操作結果のみ

指定 Webhook を削除します。

パラメータ

項目名
型
説明
id
string必須
Webhook ID

注記

  • 削除は不可逆です。一時停止したい場合は active: false での更新を推奨。

使用例（cURL）

"kw">curl -X DELETE https://api.trend-x.pro/v1/webhooks/whk_8a4f2c1d \ "kw">-H "Authorization: Bearer sk_live_xxx"
POST /v1/webhooks/{id}/test テスト送信 無料
無料

登録した Webhook URL にテスト通知を送信します。クレジット消費なし。

パラメータ

項目名
型
説明
id
string必須
Webhook ID

注記

  • 登録した URL にダミーペイロードでテスト通知を送信します。
  • 署名の検証ロジックや受信処理の確認に最適。
  • クレジット消費なし（無料）。

使用例（cURL）

"kw">curl -X POST https://api.trend-x.pro/v1/webhooks/whk_8a4f2c1d/test \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "webhook_test", "delivered": true, "status_code": 200, "response_time_ms": 142 }
⚙️

アカウント管理

API キー発行、クレジット残高確認、使用履歴、プロフィール編集などのアカウント操作。

利用状況把握クレジット管理API キー再発行
6 機能
GET /v1/account アカウント情報 無料
無料

認証中のアカウント情報（メール、プラン、登録日など）を取得します。クレジット消費なし。

パラメータ

パラメータなし

注記

  • 認証中の トレンドXサポート アカウントの情報を返します。
  • クレジット消費なし。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/account \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "account", "id": "acc_8a4f2c1d", "email": "user@example.com", "plan": "pro_pack", "x_account_connected": true, "x_handle": "myhandle", "created_at": "2026-04-01T00:00:00Z" }
GET /v1/account/credits クレジット残高 無料
無料

現在のクレジット残高、購入履歴、消費履歴を取得します。クレジット消費なし。

パラメータ

パラメータなし

注記

  • 現在のクレジット残高、累計購入数、累計消費数を返します。
  • クレジット消費なし。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/account/credits \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "credits", "balance": 13427, "total_purchased": 14000, "total_used": 573, "plan": "pro_pack", "updated_at": "2026-05-15T10:30:00Z" }
GET /v1/account/usage 使用状況 無料
無料

API 使用状況の統計（リクエスト数、エンドポイント別利用、日次推移）を取得します。

パラメータ

項目名
型
説明
since
string
集計開始日（ISO 8601）
until
string
集計終了日（ISO 8601）

注記

  • 期間を指定して API 使用統計を取得できます。
  • エンドポイント別の使用回数、日次推移、平均レスポンスタイムを含みます。
  • クレジット消費なし。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/account/usage \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "usage", "total_requests": 12453, "total_credits_used": 12503, "by_endpoint": {"GET /v1/posts/{id}": 5000, "POST /v1/posts": 200}, "daily": [{"date": "2026-05-15", "requests": 312}] }
GET /v1/account/keys API キー一覧 無料
無料

発行済みの API キー一覧を取得します。キー本体は表示されず、プレフィックスのみ表示されます。

パラメータ

パラメータなし

注記

  • 発行済み API キーの一覧を返します。
  • セキュリティのため、キー本体は表示されず、プレフィックスのみ表示されます（例: sk_live_xxxx****）。
  • クレジット消費なし。

使用例（cURL）

"kw">curl https://api.trend-x.pro/v1/account/keys \ "kw">-H "Authorization: Bearer sk_live_xxx"

成功時のレスポンス (200 OK)

{ "object": "list", "data": [{"object": "api_key", "id": "key_8a4f2c1d", "name": "production", "prefix": "sk_live_xxxx****", "mode": "live"}] }
POST /v1/account/keys API キー発行 無料
無料

新しい API キーを発行します。発行直後の 1 回のみキー本体が返されます。再表示できません。

パラメータ

項目名
型
説明
name
string必須
キーの識別名（例: production-server）
mode
string
live または test（デフォルト live）

注記

  • 新規 API キーを発行します。発行直後のレスポンスでのみキー本体が表示され、以降は再表示できません。
  • 本番用（live）とテスト用（test）の2モード。テスト用キーはクレジットを消費しません。
  • 用途別にキーを分けることで、漏洩時の影響を最小化できます。
  • クレジット消費なし。

使用例（cURL）

"kw">curl -X POST https://api.trend-x.pro/v1/account/keys \ "kw">-H "Authorization: Bearer sk_live_xxx" \ "kw">-H "Content-Type: application/json" \ "kw">-d '{"name":"production-server"}'

成功時のレスポンス (200 OK)

{ "object": "api_key", "id": "key_8a4f2c1d", "key": "sk_live_xxxxxxxxxxxxxxxx", "name": "production-server", "mode": "live", "created_at": "2026-05-15T10:30:00Z" }
DELETE /v1/account/keys/{id} API キー削除 無料
無料

指定 API キーを失効させます。失効後は即座に認証エラーとなります。

パラメータ

項目名
型
説明
id
string必須
API キーID

注記

  • 失効後は即座に認証エラーとなります。
  • 削除は不可逆です。
  • クレジット消費なし。

使用例（cURL）

"kw">curl -X DELETE https://api.trend-x.pro/v1/account/keys/key_8a4f2c1d \ "kw">-H "Authorization: Bearer sk_live_xxx"
← トップに戻る
support@trend-x.pro