본문으로 건너뛰기

사용자 수집 스크립트 설정

scrape_users는 실제 Android 기기의 UI에서 팔로워, 팔로잉 또는 검색 결과의 사용자 이름을 내보냅니다. Pro 빌드에서 TikTok, Instagram, Threads를 지원합니다.

script_config​

매개변수형식필수기본값설명
modestring아니요followersfollowers, following 또는 keyword
target_usernamestring조건부""목록을 열 계정
search_keywordstring조건부""keyword 모드 검색어
max_scrape_countinteger아니요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
    }
  }'

사용자 이름은 한 줄에 하나씩 <work_dir>/download/에 저장합니다. 파일명은 <target>_followers.txt, <target>_following.txt 또는 <keyword>.txt이며 다음 실행은 같은 파일에 추가합니다. 상한에 도달하거나 새 행이 없으면 중지합니다.

오류 코드​

코드설명
40001선택한 모드에 필요한 계정이나 검색어가 없음
40003선택한 빌드나 플랫폼에서 지원하지 않음
40301API 사용에는 Pro 이상 요금제가 필요

관련 문서​