Configuração do script de coleta de usuários
scrape_users exporta nomes de usuário de seguidores, seguidos ou resultados de pesquisa usando a interface de um Android real. A versão Pro é compatível com TikTok, Instagram e Threads.
script_config
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| mode | string | Não | followers | followers, following ou keyword |
| target_username | string | Condicional | "" | Conta cuja lista será aberta |
| search_keyword | string | Condicional | "" | Consulta do modo keyword |
| max_scrape_count | integer | Não | 50 | Máximo de novos usuários (1–10.000) |
target_username é necessário para followers/following; search_keyword para keyword.
Exemplo de 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
}
}'
Os nomes são salvos, um por linha, em <work_dir>/download/. Os arquivos são <target>_followers.txt, <target>_following.txt ou <keyword>.txt; execuções futuras acrescentam ao mesmo arquivo. O script para ao atingir o limite ou quando não há novas linhas.
Códigos de erro
| Código | Descrição |
|---|---|
| 40001 | Falta a conta ou a pesquisa exigida pelo modo |
| 40003 | Script não disponível na compilação ou plataforma escolhida |
| 40301 | A API exige o plano Pro ou superior |