Configuración del script de recopilación de usuarios
scrape_users exporta nombres de usuario de seguidores, seguidos o resultados de búsqueda mediante la interfaz de un Android real. La versión Pro es compatible con TikTok, Instagram y Threads.
script_config
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| mode | string | No | followers | followers, following o keyword |
| target_username | string | Condicional | "" | Cuenta cuya lista se abrirá |
| search_keyword | string | Condicional | "" | Consulta del modo keyword |
| max_scrape_count | integer | No | 50 | Máximo de usuarios nuevos (1–10.000) |
target_username es obligatorio para followers/following; search_keyword para keyword.
Ejemplo de API para 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
}
}'
Los nombres se guardan, uno por línea, en <work_dir>/download/. Se usan <target>_followers.txt, <target>_following.txt o <keyword>.txt y las ejecuciones posteriores añaden al mismo archivo. El script se detiene al alcanzar el límite o cuando no aparecen filas nuevas.
Códigos de error
| Código | Descripción |
|---|---|
| 40001 | Falta la cuenta o búsqueda requerida por el modo |
| 40003 | El script no está disponible en la compilación o plataforma elegida |
| 40301 | La API requiere el plan Pro o superior |