n8n で BeatAPI を使う

用途に合った接続方法を選んでください。モデル用の認証情報、HTTP ワークフロー、公開された n8n テンプレートは、それぞれ別のものです。

用途	n8n の接続方法	BeatAPI の接続先
AI Agent または LLM Chain でのテキスト処理	標準の OpenAI Chat Model	`https://api.beatapi.io/v1` と `GET /v1/models` で取得した正確な ID
Social Data または Web 調査	Header Auth を設定した HTTP Request	詳細を確認した機能、または文書化された Data/Web エンドポイント
画像、動画、ミュージックビデオ	HTTP Request、Wait、回数や時間を制限したステータス確認ループ	一度だけ作成し、タスク ID を保存してからステータスをポーリング

認証情報を設定する

OpenAI Chat Model では、BeatAPI のキーとベース URL https://api.beatapi.io/v1 を指定した OpenAI 認証情報を作成します。HTTP Request ノードでは、ヘッダー名を Authorization、値を Bearer <your BeatAPI key> とした Header Auth 認証情報を作成します。実際のキーは n8n の認証情報に保存し、エクスポートする JSON に含めないでください。

ワークフローをインポートする

BeatAPI の n8n サンプルには、機能実行ワークフロー、公開 Social Data を調査する 3 つのワークフロー、ミュージックビデオワークフローがあります。現在の Social Data の変更は PR #20 にあります。この PR はレビュー対象の変更であり、マージ済みのリリースや n8n Marketplace の掲載ではありません。

ワークフローの JSON をダウンロードし、n8n にインポートします。
Configure Inputs を開き、サンプル値を置き換えます。
すべての BeatAPI HTTP Request ノードに Header Auth 認証情報を割り当てます。
有料の実行前に、選択した機能の入力、出力、料金、実行手順を確認します。
一度テスト実行し、n8n の実行 ID とともに BeatAPI のリクエスト ID またはタスク ID を保存します。

非同期処理では、課金対象のタスクを再作成せずにステータスの取得だけを再試行します。成功、失敗、または所定のタイムアウトでループを終了してください。n8n のタイムアウトだけでは、BeatAPI のタスクが失敗したとは判断できません。

検証状況

2026 年 9 月 26 日時点で、3 つの Social Data JSON ファイルはローカルの n8n インスタンスにインポート済みです。X のキーワードワークフローはローカルの n8n で実行を完了しました。Instagram と YouTube は API とインポートの検証を行いましたが、n8n での一連の実行は完了していません。X のテンプレートは、担当者による審査のため n8n Creator Portal に提出済みです。最新の配布状況は PR #20 と n8n のテンプレートディレクトリで確認してください。

これらのサンプルは標準ノードだけで利用できます。BeatAPI 専用の n8n コミュニティノードは公開していません。