Threadsスクレイパー — 投稿・プロフィール・ハッシュタグ・キーワード検索

Meta Threads向けのオールインワン・スクレイパー。ユーザープロフィール、ハッシュタグ、キーワード検索、単一投稿と返信、カスタムフィードの5つのモードを1つのアクターに集約。

ログインやAPIトークンは不要。最大100件のユーザー名やキーワードの一括入力に対応しており、初期費用なしの1件$0.005というシンプルな従量課金制です。Metaの公式APIを構築する手間を省き、迅速にデータを取得したいマーケター、リサーチャー、SaaS開発者、ソーシャルリスニングチームに最適なツールです。

---

取得可能なデータ

各投稿データ:

• postId、postUrl、content、publishedAt、publishedAtISO
• メディア情報: mediaType（text / photo / video / carousel）、mediaUrls[]
• エンゲージメント: likeCount、replyCount、repostCount、shareCount、viewCount、quoteCount
• ソース情報: sourceType（取得モード）、sourceQuery（対象ユーザー名 / キーワード / URL）
• scrapedAt（取得時のタイムスタンプ）
• threadParts[] — 複数セグメントにわたるスレッド投稿を自動的にマージして保持。

投稿者情報:

• author ハンドル（ユーザー名）

返信データ（postモードのみ）:

• replies[] — 主要な返信を最大20件（author、content、publishedAt、likeCountを含む）

注意: データセットのフィールドキーは英語で統一されているため、後続の解析ツールやワークフローとの高い互換性を保ちます。

---

5つのモードを1つのアクターで実現

モード	機能	入力フィールド
👤 User	特定プロフィールの全投稿を取得	usernames[]
🏷️ Hashtag	ハッシュタグやトピックページを取得	keywords[]
🔎 Search	キーワード検索（人気順 / 最新順）	keywords[] + searchSort
💬 Post	特定の投稿と最大20件の主要な返信	postUrls[]
📰 Feed	任意のThreadsカスタムフィードURL	feedUrls[]

実行ごとに Mode ドロップダウンから1つを選択します。競合ツールでは4〜5個のアクターに分かれている機能を1つのコードベースに統合しているため、インテグレーションが非常にシンプルです。

---

入力パラメータ

フィールド	型	必須	デフォルト	説明
mode	enum	推奨	user	user、hashtag、search、post、feedから選択。未入力時は自動判定。
usernames	string[]	user時	—	ユーザー名のみ。@やURLは不要。最大100件。
bulkUsernames	string	任意	—	複数ユーザー名の一括貼り付け用（スプレッドシートの列をそのままコピー可能）。
keywords	string[]	hashtag/search時	—	キーワードまたはハッシュタグ（#は省略可）。最大100件。
bulkKeywords	string	任意	—	キーワードの一括貼り付け用。
postUrls	string[]	post時	—	投稿の完全なURL。返信も自動取得します。
feedUrls	string[]	feed時	—	ThreadsカスタムフィードのURL。
searchSort	enum	任意	top	top（人気）またはrecent（最新）。searchモードで適用。
dateFrom	string	任意	—	YYYY-MM-DD または相対指定（例: 7 days、1 month）。
dateTo	string	任意	—	dateFromと同じ形式。
maxPosts	integer	任意	50	1ソースあたりの最大取得件数（1〜500）。自動スクロール対応。

---

注意事項と制約

• maxPosts は上限値です: 非アクティブなアカウントやニッチなタグでは、指定数より少なくなる場合があります。5回連続で新しい投稿が検出されない場合は早期終了します。
• 相対日付の評価: "7 days" などの指定は実行時の日付に基づきます。定期的なスケジュール実行に便利です。
• エンゲージメント数値は概算です: Threads側で「12.5K」のように省略表記される場合、ツール側で「12500」に正規化するため、正確な1の位までの数値ではない可能性があります。
• 公開データのみに対応: ログイン不要で動作するため、非公開アカウントやフォロワー限定コンテンツは取得できません。
• スレッドの自動結合: 複数に分かれた投稿（1/3、2/3...）は threadParts[] を通じて1つのレコードとしてマージされます。

---

FAQ

Q: ユーザー名の指定形式は？ zuck のような純粋なユーザー名を入力してください。@zuck や URL 形式でも自動的にクレンジングされます。

Q: maxPosts より取得件数が少ないのはなぜ？ 投稿自体が少ないか、Threadsの仕様でそれ以上のスクロールが制限された可能性があります。詳細はログの totalItems を確認してください。

Q: 一部のデータが null や 0 になっています。 Threads側でデータが生成されていない（例：閲覧数がまだカウントされていない）場合に発生します。これはツールの不具合ではなく、ソース側のデータ欠損です。

Q: 対応している出力形式は？ JSON、CSV、Excel、XML、HTMLに対応。Apifyの標準機能により、Zapier、Make、n8n、Googleスプレッドシート等との連携も容易です。

---

公式APIとの違い

Metaの公式APIには、公開データの収集において以下の制約があります。

• 自アカウント限定: 自分が管理するアカウントのデータしか取得できず、競合調査やトレンド分析には向きません。
• 審査の壁: アプリレビューやOAuthの設定など、導入までのハードルが高いです。

本ツールは、市場調査、ソーシャルリスニング、競合分析など、ログインなしで閲覧可能な公開データを効率的に収集することに特化した、より手軽な選択肢です。

---

免責事項

本スクレイパーは公開されているThreadsデータのみを収集します。非公開データへのアクセスや認証の回避は行いません。利用者は、本ツールの使用が各地域の法律（GDPR、個人情報保護法等）およびMetaの利用規約に準拠していることを自ら確認する責任を負います。スパムや嫌がらせ目的での使用は禁止されています。