FeaturesPricingBlogResourcesAboutContact
Sign inGet Started Free

X(旧Twitter)のタイムラインをホームページに埋め込む、文章のポストが主役のXフィードウィジェット

アカウントを接続して、公開するポストを選び、お使いのホームページにコードをひとつ貼り付けるだけです。ポストの本文はカードの中に表示されるので、読む人をXへ送り出さずに、その場で読んでもらえます。写真があれば大きく載せますが、写真がなくても成り立つように作っています。

7日間の無料トライアルでXも使えます。クレジットカードは不要です。

クラブ公式アカウントより
Lampblack Runners3時間前

今夜、クラブの1500m記録が更新されました。4分11秒6、2回目の挑戦で、誰も話題にしたがらない向かい風の中でした。明日の朝、記録ボードに新しい1行が加わります。

4026348
Lampblack Runners11時間前

濡れたアスファルトに、灰色の川。おしゃべりできるペースで10キロ。一年でいちばんいいランは、いつも一年でいちばんひどい天気の日にやってきます。

濡れた海沿いの遊歩道を走るランナー。手すり沿いには空いたベンチが並び、背後には霞んだ吊り橋と街のスカイラインが見える。
143917

Lampblack Runnersは架空のランニングクラブで、住所も架空、写真はCC0の代替画像です。カラムの幅、画像の切り抜き方、数値の表示はウィジェットのものです。

1
有料プランが必要なソースはXだけ
12時間
有料プランでの更新間隔。どの有料プランでも同じ
40
デザインスタジオのレイアウト
16
すべてのプランで無料のテーマ

Xのタイムライン埋め込みが表示されない。公式ツールを検証してわかったこと

Xのタイムライン埋め込みが表示されないのには、はっきりした理由があります。2026年8月、X公式の埋め込みツール(publish.x.com)で入力できる4種類(ポストのURL、プロフィールのURL、@ハンドル名、ハッシュタグ)をすべて試しました。結果は次のとおりです。

単一ポストのURL:正常に表示

本文、画像、エンゲージメント数の入ったカードがプレビューされ、ページに貼り付けてもそのまま表示されました。記事の中でポストを1件引用するだけなら、公式ツールで十分です。

プロフィールのURL:文字リンクだけ

「Embedded Timeline」を選んでも、プレビューに出たのはフィードではなく「Posts by(アカウント名)」という文字だけでした。しかも生成されたリンクの行き先はx.comではなく、存在しないs.comのURLです。貼り付けても、タイムラインは表示されません。

@ハンドル名:同じ症状

X自身が入力例に挙げている@XDevelopersでも、生成されたのは同じ文字リンクと、壊れたs.comのリンクでした。

ハッシュタグ:埋め込みの選択肢なし

タイムラインの選択肢そのものが表示されず、生成されるのは投稿ボタンだけです。公式ツールでハッシュタグのフィードを埋め込む方法はありません。

このウィジェットが、同じ理由では消えないわけ

CollectSocialsのウィジェットは、X公式の埋め込みスクリプト(widgets.js)をお使いのページで読み込みません。ポストはXの公式API v2から取得して当社側に保存し、そこから配信します(アカウントのソースは承認いただいたトークン、ハッシュタグのソースは当社のアプリ認証で読み込みます)。ページが表示されるたびにXへ問い合わせるわけではないので、閲覧者がXにログインしているかどうかに表示が左右されません。タイムラインもハッシュタグも、貼り付けたその場所にフィードとして表示されます。

旧twitter.comのURLが残ったコード、鍵アカウント、SquarespaceやWebflowの編集画面だけで起きる制限など、ほかの原因の切り分け方は、Xの埋め込みが表示されない7つの原因で、検証したときの画面と一緒に解説しています。

Xのポストはほとんどが文章。だから、1件に1行を使うレイアウトが合います

練習の中止、大会の結果、集合場所の変更。まずはポストごとに1行を使うListで見て、そこからレイアウトやテーマを切り替え、本文、日付、アイコン、バッジの表示をオンにしたりオフにしたりしてみてください。登録も接続も要りません。下のポストは、ランニングクラブが実際に書きそうな内容にしています。

レイアウト
テーマ
表示項目
表示中: List Minimal
赤い陸上トラックに描かれた1500mのスタート表示。地面の高さから撮影し、背景のスタジアムはぼけている。

今夜、クラブの1500m記録が更新されました。4分11秒6、2回目の挑戦で、誰も話題にしたがらない向かい風の中でした。明日の朝、記録ボードに新しい1行が加わります。

濡れた海沿いの遊歩道を走るランナー。手すり沿いには空いたベンチが並び、背後には霞んだ吊り橋と街のスカイラインが見える。

濡れたアスファルトに、灰色の川。おしゃべりできるペースで10キロ。一年でいちばんいいランは、いつも一年でいちばんひどい天気の日にやってきます。

濡れたアスファルトの水たまりに、建物と葉のない枝が逆さまに映っている。

火曜のインターバルは中止です。トラックが一面の氷で、さすがに走れません。代わりに同じ時間、同じ場所から、ロードを軽く8キロ。

霧が木々の間に立ちこめる公園。葉を落とした木と赤茶色に色づいた木が並び、芝生には落ち葉が広がっている。

朝6時、霧の公園ループ、気温4度。遅れた人はゼロでした。木曜は同じコースを逆回りで走ります。

List. 1行に1ポスト、本文を画像の横に。Xのタイムラインを読む感覚にいちばん近く、文章が中心のフィードなら、ここから始めるのがおすすめです。

自分のフィードで作ってみる

これは実際のレンダラーではなくプレビューです。テーマの色は製品のテーマ定義をそのまま読み込み、レイアウト名も実物と同じですが、ここに描いている形はこのページのためのものです。ウィジェットのレンダラーはDenoのエッジ関数で動いていて、このサイトのNextアプリからは読み込めないためです。描いた形を成り立たせるためにプレビューのポストにはすべて写真を付けていますが、実際のXのフィードは文章が中心で、ウィジェットは写真のないポストも文章のカードとして表示します。実際のデザインスタジオには40種類のレイアウトと16種類のテーマ、すべてのプランで使えるテーマビルダーがあり、編集中は本物のウィジェットが描画されます。Lampblack Runnersは架空のクラブで住所も架空、写真はCC0の代替画像です。

1枚のカードに載るもの、項目ごとに

ここに並べたのは、配信時にウィジェットへ渡される項目そのもので、これ以外のものはカードに届きません。項目が決まっているからこそ、下の枠では、カードに載らないものもはっきり書けます。

ポストの本文

別のページへ送り出すための抜粋ではなく、XのAPIが返す本文をそのままカードに収めます。標準では5行ほどを表示して、残りは「続きを読む」で開きます。表示する行数はレイアウトで変えられ、行数の制限をなくすこともできます。

表示名とアイコン

Xから返ってくるアカウント名とプロフィール画像です。プロフィール画像が届かないときは、アイコンの場所を空けずに名前の頭文字を描きます。

画像は1枚、あるときだけ

ポストに添付された最初の写真です。文章だけのポストは画像を持たないだけで、それは失敗ではなく、ごく普通の状態です。

経過時間(切り捨て)

投稿からの経過時間を表示します。四捨五入ではなく切り捨てにしているので、ダッシュボードと埋め込んだウィジェットで、同じポストの経過時間が食い違うことはありません。

いいね・返信・リポスト

3つの数値を表示し、プラットフォーム側に数値がないものは個別に隠します。リポストと引用ポストは別々の数値で届き、足し合わせてひとつのリポスト数として表示します。

元のポストへのリンク

どのポストも、x.com上の自分のURLを持っています。標準ではカードをクリックすると、ポストの本文と「Twitterで見る」ボタンのあるパネルが開きます。元のポストを直接開く設定や、クリックできないカードにする設定も選べます。

カードに載らないもの、その理由

名前の下に@ハンドルはありません。配信時にウィジェットへ渡される項目は決まっていて、アカウントのハンドルはそこに含まれていないからです。ポストを見分ける手がかりは、名前と経過時間と、元のポストへのリンクです。

フォロワー数や認証バッジもありません。表示するのはポストが持っている情報で、アカウントのプロフィール情報ではありません。

写真はサムネイルではなく、幅いっぱいに

ポストに添付された最初の画像は、本文の上に、カラムの幅いっぱいで表示されます。文章が中心のフィードでは写真のほうが例外なので、壁紙のように埋もれず、出てきたときにきちんと目を引きます。

赤い全天候型トラックに描かれたレーン番号を、レーンのラインに沿って低い位置から撮った写真。光は柔らかく平坦。
Lampblack Runners5日前

第1レーンの塗り直しが終わり、24日からクラブのハンデ戦が再開します。エントリーはホワイトボードが埋まりしだい締め切りです。

128159

Lampblack Runnersは架空のランニングクラブで、住所も架空、写真はCC0の代替画像です。カラムの幅、画像の切り抜き方、数値の表示はウィジェットのものです。

有料プランで選ぶのはXのソース数。どのソースも12時間ごとに更新

XのAPIは、返ってきたポストの件数に応じて課金されます。Xがこの製品で唯一の有料ソースである理由はそれだけです。知っておくべき数字はソース数と更新間隔の2つで、どちらもこのページに書いてあります。

Proでの初回取得
リクエストしたポスト数50
Xが返したポスト数34
Collectに届いたポスト34
以降は12時間ごと新しいポストだけ

数値は説明用ですが、流れは実際のとおりです。初回取得の件数を自分で決め、Xはアカウントに実際にある分だけを返し、以降の同期は、それより新しいポストだけを取りにいきます。

有料プランなら、どれも12時間ごと

XのAPIは返したポストの件数で課金されるため、Xは有料プランのどれでも12時間ごとに更新されます。更新間隔はプランによって変わらず(ProでもScaleでも同じ)、ほかのSNSより意図的に遅くしています。無料トライアル中のXソースは1日1回の更新です。Instagram、Facebook、TikTokなど、X以外のSNSはプランの更新頻度で同期します。

新しいポストがなければ、何も取り込まない

同期のたびにXへ求めるのは、保存済みの最新ポストより新しいものだけです。新しいポストのない週は何も返ってこず、フィードもそのままです。この目印はソースを削除して追加し直しても残るので、追加し直したせいで取得済みのポストをもう一度取り込むことはありません。

スクレイピングではなく、公式API

ポストはすべて、Xが公開して文書化しているAPI v2を通じて、正規の認証で届きます。ソース数に上限があるのはそのためです。x.comの画面を読み取る方法ではないので、Xがページの作りを変えても、フィードは影響を受けません。

Pro:Xソース1件・12時間ごとに更新

どのソースも、プロフィールのタイムラインか公開ハッシュタグの検索のどちらかにできます。初回取得は標準で50件で、確定する前に変更できます。その後は新しいポストだけを取得します。

Business:Xソース2件・12時間ごとに更新

どのソースも、プロフィールのタイムラインか公開ハッシュタグの検索のどちらかにできます。初回取得は標準で100件で、確定する前に変更できます。その後は新しいポストだけを取得します。

Scale:Xソース5件・12時間ごとに更新

どのソースも、プロフィールのタイムラインか公開ハッシュタグの検索のどちらかにできます。初回取得は標準で100件で、確定する前に変更できます。その後は新しいポストだけを取得します。

最新のポストは自動で反映。有料プランでは12時間ごと

仕組みは2つあります。Xのソースはフィードのほかのソースとは別のスケジュールで更新され、次の更新を待たずに取得できるボタンは、有料プランの機能です。

自動更新

有料プランのXフィードは12時間ごとに更新

自動で更新されますが、プランの一般的な更新頻度とは別です。XのAPIは返したポストの件数で課金されるため、Xは有料プランのどれでも12時間ごと、無料トライアル中は1日1回の更新です。そのため、新しいポストがページに出るまで、最大で1サイクルかかることがあります。

有料プランはすべて12時間ごと・無料トライアルは1日1回

手動で取得

「Pull now」を押せば、待たずに取得

有料プランでは、定期の同期の合間に手動で取得できます。1回に最大100件、1時間に1回までです。今朝投稿したものを、次のサイクルまで待たずにページへ出せます。

1回100件まで・1時間に1回・有料プラン

XのソースがほかのSNSより遅い理由

プランには基本の更新頻度があり(無料プランの1日1回から、上位のプランでは数分おきまで)、Instagram、Facebook、TikTokなどのソースはそれに従います。Xのソースはその設定をそのまま使わず、それと自分の下限のうち遅いほうで動きます。従量課金のAPIで更新間隔を縮めると、新しいポストがなくても確認のたびに費用がかかるからです。イベントウォールはほかのプラットフォームを2分おきの更新に引き上げますが、同じ理由で、Xだけはそのままにしています。

写真がなくても崩れない、文章のためのレイアウト

写真向けに作られたグリッドに文章のフィードを流すと、灰色の四角が並ぶだけになります。ここで紹介する3つは、文章に合わせて形を決めたレイアウトです。40種類のレイアウトと16種類のテーマはすべてXのフィードで使え、無料プランには40種類のうち7種類のレイアウトと、すべてのテーマ、テーマビルダーが含まれます。

Lampblack Runners1日前

火曜のインターバルは中止です。トラックが一面の氷で、さすがに走れません。代わりに同じ時間、同じ場所から、ロードを軽く8キロ。

Lampblack Runners4日前

はじめての方へ。火曜か木曜の18時半に来てください。入会届も会費もありません。ひとりきりで走らせることも絶対にありません。

Lampblack Runners3時間前

今夜、クラブの1500m記録が更新されました。4分11秒6、2回目の挑戦で、誰も話題にしたがらない向かい風の中でした。明日の朝、記録ボードに新しい1行が加わります。

List 無料プラン

1行に1ポストずつ、文章を主役に並べます。Xのタイムラインを読む感覚にいちばん近く、たいていのページはここから始めるのがおすすめです。

Lampblack Runners3時間前

今夜、クラブの1500m記録が更新されました。4分11秒6、2回目の挑戦で、誰も話題にしたがらない向かい風の中でした。明日の朝、記録ボードに新しい1行が加わります。

Quote wall

1件ずつ大きく表示し、残りはその後ろで待機します。ページの3分の1ではなく、幅いっぱいで読ませたい一文のために。

Lampblack Runners6日前

3月まではヘッドライトの季節です。反射するものをひとつしか持っていないなら、振るほうの腕に付けてください。

雨の夜の通りを、黒い傘をさして歩く人の後ろ姿。車や店の明かりが濡れた路面に長い色の反射を落としている。
Lampblack Runners4日前

はじめての方へ。火曜か木曜の18時半に来てください。入会届も会費もありません。ひとりきりで走らせることも絶対にありません。

Social news

画像つきのリードポストの下に見出しを並べるので、文章と写真が混ざった1週間でも、ひとつのカラムとして読めます。

アカウントのタイムラインも、ハッシュタグも、公式APIで

ProはXソース1件、Businessは2件、Scaleは5件。どのソースもどちらの種類にでき、すべて12時間ごとに更新されます。

自分のアカウント

プロフィールのタイムライン

アカウントを接続すると、ウィジェットはそのアカウント自身のポストを読み込みます。取得するのはオリジナルのポストだけで、リポストと返信はリクエストの段階で除外します。ページに出るのは、そのアカウントが拡散したものではなく、自分で書いたものです。

ハッシュタグ

公開ハッシュタグの検索

アカウントの代わりにハッシュタグを指定すると、公開されている直近の検索エンドポイントを読み込みます。アカウントの接続は要らず、こちらでもリポストと返信は除外されます。有料プランならどれでも使え、無料トライアル中も試せます。

スクレイピングなし

公式APIだけで取得

ポストはすべて、XのAPI v2から正規の認証で取得します。x.comの画面を読み取る方法ではないので、Xがページの作りを変えても、フィードは影響を受けません。

ホームページへの設置は4ステップ。各ステップの画面つきで

2つ目のステップは、ほかのプラットフォームにはないものです。初回の取得でアカウントの過去のポストをどこまでさかのぼるかを、自分で決められます。それ以降は、新しいポストだけを取得します。

ステップ1

アカウントを接続する

ソースの一覧で「X / Twitter」を選び、X自身の画面で読み取りアクセスを承認します。ハッシュタグのソースは公開検索のエンドポイントを読むので、接続そのものが要りません。

ソースを追加
X / Twitterツイートとハッシュタグ接続

これを選ぶと、Xのサインイン画面に移って読み取りアクセスを承認します。その画面はX自身のもので、当社がパスワードを受け取ることはありません。

ステップ2

取り込む過去の件数を決める

過去のポストまでさかのぼるのは初回の取得だけなので、決まった件数を押しつけられるのではなく、件数を自分で決めます。それ以降は新しいポストだけです。

初回取得

初回の取得でどこまでさかのぼるかを決めます。標準の件数も上限もプランで決まり、どちらも確定する前に作成画面に表示されます。

ステップ3

公開するポストを選ぶ

新しいポストは標準ではそのまま表示され、Collectページで1件ずつ除外できます。フィードの設定で「Pre-approve posts」をオンにすれば、承認したポストだけが表示されます。キーワードルールを設定すれば、一致したポストは届いた時点でページに出なくなります。承認、除外、キーワードルールは無料プランを含むすべてのプランで使え、先頭へのピン留めは有料プランと7日間のトライアル中に使えます。

Collect

今夜、クラブの1500m記録が更新されました。4分11秒6、2回目の挑戦で、誰も話題にしたがらない向かい風の中でした。明日の朝、記録ボードに新しい1行が加わります。

火曜のインターバルは中止です。トラックが一面の氷で、さすがに走れません。代わりに同じ時間、同じ場所から、ロードを軽く8キロ。

承認、先頭にピン留め(有料プランとトライアル)、または除外。キーワードルールに一致したポストは、届いた時点でページに出なくなります。

ステップ4

コードをひとつ貼り付ける

埋め込み画面で設置先を選ぶと、そのサービスに合ったコードが発行されます。サービスごとの詳しい手順は、設置ガイドにまとめています。

埋め込みコード
<!-- CollectSocials -->
<div id="cs-feed"></div>
<script src=".../widget.js"
  data-feed-id="..."
  data-container="cs-feed"
  defer></script>

省略して表示していますが、属性名は実際のコードと同じで、IDは自動で入ります。スクリプトを制限するサービスにはiframe形式、スクリプトを一切動かせないサービスにはURL形式のコードが発行されます。

WordPress、Shopify、Wix、Squarespace、Webflowのそれぞれで、コードをどこに貼るかは設置ガイドのプラットフォーム別の手順にまとめています。このページは判断の材料、ガイドは手順書です。

WordPress・Wix・Notionなど、主要なホームページ作成サービスに埋め込めるコード

scriptタグは、どこにでもそのまま貼れるわけではありません。外部のコードを隔離するサービスもあれば、取り除いてしまうサービスもあります。そこで埋め込み画面では最初に設置先を尋ね、そのサービスに合ったコードを発行します。

スクリプト埋め込み

HTML・WordPress・Webflow・React

scriptタグ1つと、コンテナのdiv 1つです。ウィジェットはShadow DOMの中に描画されるので、ウィジェットのCSSとホームページのCSSが互いに干渉しません。

ラッパー付きスクリプト

Shopify

同じスクリプトを、ページ幅のラッパーで包んだコードです。Shopifyのテーマはセクションをflexboxで並べるので、そのままではコンテナが押しつぶされてしまいます。

iframe埋め込み

Wix・Squarespace

どちらもカスタムスクリプトを隔離したり取り除いたりするため、iframeのコードを発行します。サイトがコード内の小さなスクリプトの実行を許可していれば、iframeの高さは読み込んだ内容に合わせて自動で調整されます。

URLだけ

Notion・Googleサイト

スクリプトをまったく実行できないサービスには、URLで指定する固定の高さの枠を発行します。内容は枠の中でスクロールします。

Notion、Wix、国内のホームページ作成サービスで使うとき

Notionでは、ページで「/embed」と入力して埋め込みブロックを作り、埋め込み画面でNotionを選んだときに発行されるURLを貼り付けます。高さはブロックの下端をドラッグするか、URLの中の「h=600」を書き換えて調整できます。

Wixでは、エディタの「追加」から埋め込みコードの要素を置き、発行されたiframe形式のコードを貼り付けて公開します。

STUDIO、Jimdo、ペライチ、BASE、Ameba Owndなどを使っている場合も、HTMLを貼り付けられるブロックがあるサービスなら、埋め込み画面で「Plain HTML」を選んだときのコードを試せます。ブログも同じで、スクリプトを含むHTMLを貼り付けられるなら、通常のコードがそのまま使えます。サービスによっては編集画面でスクリプトが動かず、公開後のページで初めて表示されるものもあります(SquarespaceやWebflowがその例です)。表示の確認は、公開したページで行ってください。

WordPressなら専用プラグインを使えば、コードを貼り付ける必要自体がありません。

Xのポストは、ほかのSNSと並ぶと引き立ちます

ひとつのフィードに10種類のプラットフォームをまとめられるので、Xのポストを、Instagramの写真やFacebookの投稿、Googleレビューと同じセクションに並べられます。無料プランで接続できるソースは1件なので、複数のプラットフォームを組み合わせるのは7日間のトライアルか有料プランでの構成です。

高橋さくら2週間前Google

写真を見て日の出のツアーを予約しましたが、写真以上でした。ガイドの方は、どこに、いつ行けばいいかを正確に把握していました。

海の上の嵐雲の下から夕日がのぞくなか、暗い溶岩の尾根に立つ小さな人影YouTube

尾根道の3日間、最初から最後まで

下から見上げた空中ブランコ。乗り手たちが澄んだ青空へ大きく振り出されているTikTok

ブランコが水の上まで大きく振り出されます

Atlas & Pine@atlasandpine · 3日前Twitter/X

日の出チームは、嵐が来る前に尾根までたどり着きました。写真はすべてホームページに載せています。

Atlas & Pine5週間前Facebook

ラグーンで過ごした一日。6艇で漕ぎ出して転覆はゼロ、水の色は午後のあいだずっとこのままでした。

石灰岩の断崖に挟まれたターコイズ色の入り江を進む、赤や黄色のカヤック
伊藤大輔1か月前Google

今年2回目の参加です。スケジュールはすべて時間どおりで、少人数制こそがこのツアーの良さだと思います。

明るい黄色の壁の前で、髪を顔の前に振り乱して踊る人Instagram

黄色い壁を見つけたので、もちろん踊りました。

大きく広がる太陽の光を背に、砂丘の稜線でシルエットになった2人。手前の砂には風紋Instagram

太陽より一足先に、稜線にたどり着きました。

夜明けの淡い色の奇岩の上を漂う熱気球Instagram

気球より先に起きていました。

Atlas & Pine7週間前Facebook

フェスティバルの最後に、風船を一斉に空へ。10秒ほど、誰もひと言も話しませんでした。

澄んだ青空へ一斉に昇っていく、たくさんの色とりどりの風船

架空のブランドを使ったデモフィードで、接続できる10種類のソースのうち、Instagram、Googleレビュー、YouTube、X、TikTok、Facebookをひとつのウォールに並べています。ポスト、レビューの投稿者、反応の数値は説明用で、製品の実績値ではありません。カードの各項目は実際のウィジェットが描画するものですが、このウォール自体はウィジェットが配信したものではなく、このページのために描いたものです。

有料のソースはXだけ。その理由

読み取るたびに当社へ請求が来るプラットフォームはXだけなので、有料プランが必要なソースもXだけです。Xについてお支払いいただくのは、運用できるXのソース数と、それぞれの更新頻度です。

無料(7日間のトライアルつき)
  • X / Twitter:7日間の無料トライアル
  • トライアル中のXソースは3件まで、1日1回の更新、カード登録は不要
  • 40種類のうち7種類のレイアウト、16種類すべてのテーマ
  • 承認と除外、キーワードルールによる振り分け

トライアルが終わると、Xは有料のソースになります。X以外のプラットフォームは無料プランのまま使え、接続できるソースは1件です。無料プランのウィジェットには、小さなCollectSocialsのクレジットリンクが表示されます。

有料プラン:月額$29から
  • Pro:Xソース1件・12時間ごとに更新
  • Business:Xソース2件・12時間ごとに更新
  • Scale:Xソース5件・12時間ごとに更新
  • 「Pull now」で手動取得、1回100件まで(1時間に1回)

40種類すべてのレイアウト、ハッシュタグのソース、ポストを先頭に固定するピン留め、クレジットリンクの非表示。年払いなら2か月分が無料になり、Proは年額$290、Businessは$590、Scaleは$1,190です。料金の詳細(英語)。

X(Twitter)埋め込みウィジェットのよくある質問

Xのタイムラインを埋め込んでも表示されないのはなぜですか?

まず確認したいのは、公式ツール(publish.x.com)のタイムライン埋め込みそのものが、2026年8月の検証時点でフィードではなく「Posts by(アカウント名)」という文字リンクしか生成しなくなっている点です。この場合、コードを貼り直しても直りません。ほかにも、旧twitter.comのURLのままのコード、X公式の埋め込みスクリプト(widgets.js)の読み込み失敗、ログインしていない閲覧者への表示制限、鍵アカウント化、編集画面だけの制限といった原因があり、切り分け方は設置ガイドで画面つきで解説しています。このウィジェットはXの埋め込みスクリプトを使わず、取得済みのポストを当社側から配信するので、閲覧者がXにログインしているかどうかに表示が左右されません。

Xフィードウィジェットとは何ですか?

Xのポストを、Xの外にある自分のホームページへひとつのセクションとして流し込む、埋め込み型の部品です。一度貼り付ければ自動で更新されます。X公式の埋め込みツールで確実に表示できるのはポスト1件だけなので、アカウントのタイムラインやハッシュタグをまとめて見せるには、フィードウィジェットが必要になります。

Xの埋め込みウィジェットは無料で使えますか?

いいえ。この製品で無料プランに含まれないソースはXだけです。XのAPIは返したポストの件数に応じて課金されるため、Xのフィードは更新のたびに費用がかかり、その費用をプランでまかなう必要があります。X以外のプラットフォームは、どれも無料プランで接続できます(無料プランで接続できるソースは1件です)。新規アカウントでは7日間のトライアル中、カード登録なしでXを使えます。トライアルのXソースは3件まで、更新は1日1回です。有料プランは月額$29からで、年払いなら2か月分が無料になり年額$290です。

Xのウィジェットに表示できるポストは何件までですか?

除外しなかったXのポストはフィードに残り、表示され続けます。ポストはページが表示されるたびに取りにいくのではなく、当社側に保存しているからです。上限といえるのはプラン全体の保存ポスト数だけで、これはXの数字ではなく、すべてのプラットフォームで共有する上限です。プランがXについて決めているのは、接続できるソース数と更新頻度です。Proは1件、Businessは2件、Scaleは5件で、どのソースも12時間ごとに更新されます。

埋め込んだXのタイムラインは、最新のポストに自動で更新されますか?

はい、独自のスケジュールで自動的に更新されます。ほとんどのプラットフォームはプランの一般的な更新頻度で同期しますが、Xのソースには独自の下限があり、XのAPIは返したポストの件数で課金されるため、有料プランのどれでも12時間ごとの更新です。7日間のトライアル中は、Xのソースは1日1回更新されます。有料プランでは「Pull now」を押して、すぐに取得することもできます(1時間に1回まで)。

X(Twitter)の開発者アカウントやAPIキーは必要ですか?

必要ありません。APIのアクセス権は当社が持っていて、Xのサインイン画面で、自分のアカウントへの読み取りアクセスを承認するだけです。求める権限は3つだけで、ポストの読み取り、プロフィールの読み取り、そして数時間ごとに接続し直さなくてもフィードが更新され続けるためのログイン状態の維持です。投稿、フォロー、メッセージ、削除は、どれもできません。

リポストや返信も表示されますか?

表示されません。プロフィールのソースはXにオリジナルのポストだけを求めるので、リポストと返信はそもそも届きません。ハッシュタグのソースでも、同じように除外します。返信のスレッドをサイトで見せたいなら、元のポストを公開しておき、読む人にカードからXを開いて会話を読んでもらうのが確実です。

自分のアカウントではなく、ハッシュタグのフィードを埋め込めますか?

できます。有料プランならどれでも使え、トライアル中も試せます。ハッシュタグのソースは、当社のアプリケーション認証で公開の直近検索エンドポイントを読むので、アカウントの接続は要りません。ひとつ知っておきたいのは、このエンドポイントが10件未満のリクエストを受け付けないことで、そのためハッシュタグのソースは1回に少なくとも10件ずつ取得します。手順は設置ガイドで説明しています。

XがAPIを変更したら、埋め込みはどうなりますか?

XはAPIをバージョンで管理して文書化しており、フィードのポストはすべて、そのAPIを通じて正規の認証で届いたものです。そのため、スクレイピングで作ったフィードのように、x.comのページ構造に依存しません。取得済みのポストは当社側に保存されていて、ソースの接続が切れているあいだも表示され続けるので、アカウントを接続し直すあいだにページのその部分が空白になることはありません。

ホームページに表示するポストを選べますか?

はい、すべてのプランで選べます。新しいポストは取得されるとそのままフィードに表示され、Collectページで1件ずつ除外できます。キーワードルールを設定すれば、一致したポストは届いた時点でページに出なくなります。フィードの設定で「Pre-approve posts」をオンにすると、新しいポストは承認するまでページに表示されません。これはXでとくに大事です。タイムラインの中では自然に読めるポストも、ホームページの常設セクションに置くと、妙に見えることがあるからです。承認、除外、キーワードルールは無料プランを含むすべてのプランで使え、選んだポストを先頭に固定するピン留めは、有料プランと7日間のトライアル中に使えます。16種類のテーマとテーマビルダーも、すべて無料プランに含まれます。

Xのタイムラインを埋め込むHTMLコードは、どこで手に入りますか?

デザインスタジオ右上の「Get Code」から開く埋め込み画面で、設置先に「Plain HTML」を選ぶと発行されます。中身はscriptタグ1つとコンテナのdiv 1つで、フィードIDなどの値はあらかじめ入っています。ホームページのHTMLの、フィードを表示したい位置に貼り付けて保存し、公開してください。サービスごとの貼り付け場所は設置ガイドにまとめています。

NotionにXのタイムラインを埋め込めますか?

できます。Notionはスクリプトを実行できないので、埋め込み画面でNotionを選ぶと、固定の高さの枠をURLで指定する形式が発行されます。Notionのページで「/embed」と入力し、そのURLを貼り付けてください。内容は枠の中でスクロールし、高さはブロックの下端をドラッグして調整できます。

WixやWordPressにTwitterのタイムラインを埋め込めますか?

できます。対応しているのはWordPress、Shopify、Wix、Squarespace、Webflow、Notion、Googleサイト、通常のHTML、Reactです。カスタムスクリプトを隔離するサービスもあれば取り除くサービスもあるので、埋め込み画面で設置先を選ぶと、そのサービスに合ったコードが発行されます。Wixにはiframe形式のコードが発行され、WordPressなら専用プラグインを使えば、コードの貼り付け自体が要りません。

ブログにツイートやXのタイムラインを埋め込めますか?

スクリプトを含むHTMLを貼り付けられるブログなら、埋め込み画面で「Plain HTML」を選んだときのコードをそのまま使えます。WordPressのブログなら、カスタムHTMLブロックに貼るか、専用プラグインを使います。記事の中でツイートを1件引用したいだけなら、X公式の単一ポスト埋め込みで十分で、検証でも正常に表示されました。アカウントのタイムラインやハッシュタグを、自動で更新しながらまとめて見せたいときが、このウィジェットの出番です。

TwitterとX、呼び方はどちらが正しいのですか?

どちらの名前も使われていて、この製品ではどちらでも通じます。ダッシュボードでのソース名は「X / Twitter」、ポストのリンク先はx.com、カードのマークはXのロゴで、元のポストを開くボタンの表記は今も「Twitterで見る」です。埋め込みについて実際に変わったのはロゴだけではなく、その点も設置ガイドで取り上げています。

XのポストをほかのSNSと一緒に表示できますか?

できます。ひとつのフィードに10種類のプラットフォームをまとめられるので、Xのポストを、Instagramの写真やFacebookの投稿、Googleレビューと同じセクションに並べられます。4つのウィジェットを積み重ねるのではなく、ひとつのウォールとしてデザインされます。写真が様子を見せ、ポストが出来事を伝える。多くのサイトが求めているのは、この組み合わせです。

今夜のうちに、Xのポストをホームページへ

Xを接続し、公開するポストを選び、レイアウトを決めて、コードをひとつ貼り付けるだけです。7日間のトライアルではXも使え、カード登録は要りません。

WordPress、Shopify、Wix、Squarespace、Webflow、Notion、Googleサイト、React、通常のHTMLで使えます。