Xの投稿を取得する｜ヘルプ

連携したXアカウントから投稿を取得し、分析対象の候補として一覧表示する方法を説明します。取得した投稿を分析にかける手順は「X投稿を単体・時系列で分析する」をご覧ください。

前提条件

作業画面は3つの区画に分かれています。

X投稿を分析した作品の「新しい版を追加」画面にも同じボタンがあり、同じ手順で取得できます。

左の「新しく取得」タブで条件を決め、「投稿を取得」を押します。

項目	内容
検索対象	既定は連携アカウント自身の投稿です。「タイムラインを取得」をオンにすると、連携アカウントのホームタイムライン（フォロー中のアカウントの投稿）を取得します。
取得件数	1回に取得する件数です。5〜100件で、既定は50件です。
期間	取得する投稿の期間を絞り込みます。開始日を選んだときだけ使われます。終了日を今日にすると、現在までの投稿が対象です。Xから取得できる範囲（連携アカウントの直近3,200件ほど）より古い期間を指定すると、投稿があっても0件になります。

取得が終わると「〇件の投稿を取得しました」と表示され、中央の「投稿一覧」に投稿が並びます。同じ内容は「取得履歴」にも自動で保存されます。1回の取得は1ページ分だけです。もっと多く見たい場合は、取得件数を増やして取り直してください。

投稿一覧の見出しには、取得元（「自分の投稿」または「タイムライン」）、件数、取得日時が表示されます。

各投稿には、投稿者、投稿からの経過時間、本文、画像、反応数（返信・いいね・表示回数・リポスト・引用・ブックマーク・投稿者フォロワー数）が表示されます。取得できなかった数値は「-」です。
「新しい順」「古い順」で並べ替えられます。
「Xから最新の投稿を取り直す」を押すと、左の条件でもう一度取得し、新しい取得履歴として保存します。元の履歴は上書きされません。
「反応数を更新する」を押すと、表示中の投稿の反応数だけをXから取り直し、一覧の数値を最新にします。取得履歴に保存された値は変わりません。削除された投稿などで取れなかった分は、「〇件の反応数を更新しました（〇件は削除済みなどで取得できませんでした）」のように件数付きで表示されます。表示中の投稿の件数分、XのAPIクレジットを消費します。
「投稿一覧の削除」を押すと、確認のダイアログが出ます。「履歴を削除」を押すと、表示中の取得履歴を削除します。

取得した投稿（本文・画像・反応数・投稿日時・投稿者）は、取得した時点の内容で「取得履歴」に保存され、ブランド内で共有されます。次からはXにアクセスせずに開けます。詳しくは「Xの取得履歴から投稿を再利用する」をご覧ください。

症状	原因と対処
「X（旧Twitter）から取得する」が表示されない	Xとの連携が済んでいない、またはロールがオーナー・システム管理者ではありません。
「Xとの連携が必要です。」	「SNS API統合」タブで連携してください。
「Xとの再連携が必要です。」	認可が失効しています。「SNS API統合」タブの「Xと再連携する」を押してください。
「反応数の更新に失敗しました」	Xの利用制限や接続エラー、連携の失効が原因です。時間をおいて再度お試しください。「Xとの再連携が必要です。」と出た場合は再連携してください。
「投稿の取得に失敗しました。」など	Xの利用制限（回数上限・クレジット不足）や接続エラーです。時間をおいて再度お試しください。X Developer Portal でアプリのクレジット残高も確認してください。
取得件数より少ない	投稿数が取得件数に届いていない場合や、「期間」で絞り込んでいる場合などです。
期間を指定すると0件になる	Xから取得できるのは直近の投稿（3,200件ほど）までです。それより古い期間は取得できません。期間を新しくするか、開始日を外して取り直してください。