---
title: "Xの投稿を取得する｜ヘルプ | STORYAI"
description: Xの投稿を取得するに関するSTORYAIヘルプです。
canonical_url: "https://storyai.app/help/pz7jm9herfqtbekigtqojlco"
last_updated: "2026-09-28T07:43:14.839Z"
meta:
  "og:description": Xの投稿を取得するに関するSTORYAIヘルプです。
  "og:title": Xの投稿を取得する｜ヘルプ
  "twitter:description": Xの投稿を取得するに関するSTORYAIヘルプです。
  "twitter:title": Xの投稿を取得する｜ヘルプ
---

# **STORYAIヘルプポータル**

# **Xの投稿を取得する**

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

## 前提条件

- Xアカウントとの連携が済んでいること（ [**Xアカウントを連携・再連携する**](https://storyai.app/help/eqq4o5kohlxa8ezwpjea8176)）。
- ロールがオーナーまたはシステム管理者で、課金プランに登録していること。
- 投稿の取得は、ブランド自身のXアプリのAPIクレジットを消費します。必要な件数だけ取得してください。

## 入口

1. 左のサイドバーの「分析・作成する」から「新しく分析する」を開きます（ビジネス表示では「作成する」→「分析する」）。
2. 「短文テキスト入力（X投稿含む）」タブを選びます。
3. 「X（旧Twitter）から取得する」を押すと、その下に投稿取得の作業画面が開きます。もう一度押すと閉じます。

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

- 左「投稿取得」：「新しく取得」「取得履歴」の2つのタブ
- 中央「投稿一覧」：取得した投稿
- 右「選択済み」：分析対象の確認と、分析へ進むボタン

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

## 新しく取得する

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

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

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

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

## 投稿一覧でできること

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

## 取得結果の保存先

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

## うまくいかないとき

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

## 関連記事

- [**Xアカウントを連携・再連携する**](https://storyai.app/help/eqq4o5kohlxa8ezwpjea8176)
- [**Xの取得履歴から投稿を再利用する**](https://storyai.app/help/etwarxd7jh9bh4idjfa99sfa)
- [**X投稿を単体・時系列で分析する**](https://storyai.app/help/rtzi787h9gw3rk6wjjbl7cpp)
- [**SNS分析について**](https://storyai.app/help/ufedrxg2pd2vy7l78vcz1ges)

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
