TikTok プロフィール画像ダウンローダー API

1回の POST で TikTok プロフィール画像をダウンロード。レスポンスは永久画像ダウンロード URL と完全なプロフィールメタデータを返します。

1回の POST、1つの画像
永久ダウンロード URL
柔軟なユーザー名入力
完全なプロフィールメタデータ
冪等キーサポート
サーバーサイドキー必須

リクエスト例

curl -X POST "https://api.agentbody.io/v1/tiktok/profile/picture/download" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"username":"YOUR_USERNAME"}'

レスポンス例

OpenAPI 仕様に記載されたレスポンス。

Direct TikTok profile picture link and normalized public profile metadata.

{
  "bio": "Example bio",
  "display_name": "Example Creator",
  "followers": 151200000,
  "following": 1537,
  "likes": 11300000000,
  "profile_picture_url": "https://p16-sign-va.tiktokcdn.com/example.jpeg",
  "profile_url": "https://www.tiktok.com/@example",
  "username": "example",
  "videos": 2346
}

機能特徴

tiktok.profile_picture_download 操作は1つの公開 TikTok プロフィールからアバターを取得します。サーバーが API キーを保持；エンドポイントは1回の呼び出しで永久ダウンロード URL と完全なプロフィールメタデータを返します。

1回の POST、1つの画像

POST /v1/tiktok/profile/picture/download に TikTok ユーザー名、@ハンドル、またはプロフィール URL を送信します。成功した 200 は username、display_name、bio、followers、following、likes、videos、profile_url、profile_picture_url を返します——連絡先または調査パイプラインに必要なすべてが1つのレスポンスに含まれています。

永久ダウンロード URL

profile_picture_url は期限切れの CDN リダイレクトではなく、完全に保存された画像ファイルを指しています。どのサーバー、どの IP、いつでもダウンロードできるため、検索を再実行せずにキューワーカー、CRM、またはエンドユーザーに直接渡すことができます。

柔軟なユーザー名入力

username パラメータは裸のユーザー名、@ハンドル、または完全なプロフィール URL（tiktok.com/@username）を受け入れます。API は3つの形式すべてを同じ公開プロフィールに標準化します；非公開、削除、または存在しないアカウントは 400 または 502 エラーを返します。

完全なプロフィールメタデータ

すべてのレスポンスには、ユーザー名、表示名、bio テキスト、フォロワー数、フォロー数、総いいね数、動画数、プロフィール URL を含む完全な公開プロフィールが含まれます——ユーザーのプライバシー設定方法に関係なく、すべてのアカウントで一貫しています。

冪等キーサポート

Idempotency-Key ヘッダーを渡して、重複課金なしで失敗したリクエストを安全に再試行します。ゲートウェイはキーで重複を排除するため、ネットワーク再試行が同じプロフィールの2回目の検索をトリガーすることはありません。

サーバーサイドキー必須

エンドポイントはサーバーが保持する AgentBody API キーが必要です。クライアントサイドコードでキーを公開しないでください；すべての呼び出しをバックエンド経由でルーティングしてキーを安全に保ち、使用量を追跡します。

使い方

API で TikTok プロフィール画像ダウンロードを3ステップで統合。

API キーを取得

無料 AgentBody アカウントを作成し、ダッシュボードから API キーを生成します。キーはすべてのリクエストを認証し、残高に対する使用量を追跡します。

ユーザー名を POST

/v1/tiktok/profile/picture/download に POST リクエストを送信し、リクエストボディに TikTok ユーザー名、@ハンドル、またはプロフィール URL を含めます。安全な再試行のために Idempotency-Key ヘッダーを含めます。

ダウンロードリンクを受信

成功した 200 レスポンスは永久 profile_picture_url と完全なプロフィールメタデータを返します。リンクから直接画像をダウンロードするか、メディアパイプラインに渡してストレージと配信を行います。

よくある質問

TikTok プロフィール画像ダウンローダー API はどのように動作しますか？

/v1/tiktok/profile/picture/download に POST リクエストと TikTok ユーザー名、@ハンドル、またはプロフィール URL を送信します。API はプロフィールを取得し、アバター画像を保存し、完全な公開プロフィールメタデータとともに永久ダウンロード URL を返します。

どのユーザー名形式がサポートされていますか？

API は裸のユーザー名（charlidamelio）、@ハンドル（@charlidamelio）、または完全なプロフィール URL（https://www.tiktok.com/@charlidamelio）を受け入れます。3つの形式すべてが同じ公開プロフィールに解決されます。

レスポンス形式は何ですか？

成功した 200 レスポンスは JSON オブジェクトを返します：username、display_name、bio、followers、following、likes、videos、profile_url、profile_picture_url（永久画像ダウンロードリンク）。

レート制限や使用上限はありますか？

各成功したダウンロードは、ゲートウェイ管理価格で AgentBody 残高から固定金額を消費します。アカウント残高を超える個別のレート制限はありません；失敗したリクエスト（400、502 など）は課金されません。再試行時の重複課金を防ぐために Idempotency-Key ヘッダーを使用してください。

非公開 TikTok アカウントからプロフィール画像をダウンロードできますか？

いいえ。API は公開利用可能なプロフィールのみを処理できます。非公開アカウント、削除されたアカウント、制限されたプロフィールは TikTok プラットフォームによって拒否され、400 または 502 エラーを返します。

この API を使用して TikTok プロフィール画像をダウンロードするのは合法ですか？

研究、検証、デザイン参照などの合法目的で公開利用可能なプロフィール画像にのみ API を使用してください。プライバシー権と TikTok の利用規約を尊重してください。ダウンロードした画像を他人になりすましたり、権利を侵害したりしないでください。