ユーザー収集スクリプト設定
scrape_users は、実際の Android 端末 UI からフォロワー、フォロー中、または検索結果のユーザー名を出力します。Pro 版では TikTok、Instagram、Threads に対応します。
script_config
| パラメータ | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
| mode | string | いいえ | followers | followers、following、keyword |
| target_username | string | 条件付き | "" | リストを開くアカウント |
| search_keyword | string | 条件付き | "" | keyword モードの検索語 |
| max_scrape_count | integer | いいえ | 50 | 新しく出力する最大数（1–10,000） |
followers/following では target_username、keyword では search_keyword が必要です。
Threads API の例
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "scrape_users",
"platform": "threads",
"script_config": {
"mode": "followers",
"target_username": "@creator",
"max_scrape_count": 50
}
}'
ユーザー名は 1 行に 1 件、<work_dir>/download/ に保存されます。ファイル名は <target>_followers.txt、<target>_following.txt、または <keyword>.txt で、後続の実行は追記します。上限到達または新しい行がなくなると停止します。
エラーコード
| コード | 説明 |
|---|---|
| 40001 | モードに必要なアカウントまたは検索語がない |
| 40003 | 選択したビルドまたはプラットフォームで未対応 |
| 40301 | API の利用には Pro 以上が必要 |