Configurazione dello script di raccolta utenti
scrape_users esporta i nomi utente di follower, seguiti o risultati di ricerca tramite l'interfaccia di un vero dispositivo Android. La versione Pro supporta TikTok, Instagram e Threads.
script_config
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|
| mode | string | No | followers | followers, following o keyword |
| target_username | string | Condizionale | "" | Account di cui aprire la lista |
| search_keyword | string | Condizionale | "" | Query della modalità keyword |
| max_scrape_count | integer | No | 50 | Massimo di nuovi utenti (1–10.000) |
target_username è richiesto per followers/following; search_keyword per keyword.
Esempio API Threads
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
}
}'
I nomi vengono salvati, uno per riga, in <work_dir>/download/. I file sono <target>_followers.txt, <target>_following.txt o <keyword>.txt; le esecuzioni successive aggiungono allo stesso file. Lo script si ferma al limite o quando non compaiono nuove righe.
Codici di errore
| Codice | Descrizione |
|---|---|
| 40001 | Account o ricerca mancante per la modalità scelta |
| 40003 | Script non supportato dal build o dalla piattaforma selezionata |
| 40301 | L'API richiede il piano Pro o superiore |