프로필 수집 시작

계정 URL 엑셀을 업로드해 프로필 정보 수집을 시작합니다. platform으로 인스타그램 / 틱톡을 고르며, 링크 파싱과 프로필 조회 API가 그 값으로 갈립니다.

HTTP 요청

POST /ai/admin/dm-automation/collect
Authorization: Bearer {access_token}
Content-Type: multipart/form-data

Form Data

플랫폼 (platform)

대소문자를 가리지 않습니다. 값이 없거나 모르는 값이면 INSTAGRAM으로 처리합니다(에러 아님).

계정 URL 컬럼 자동 탐지

urlColumn을 지정하지 않으면 아래 후보 컬럼명으로 먼저 찾고, 없으면 선택한 플랫폼의 도메인 (instagram.com 또는 tiktok.com) 포함 비율이 가장 높은 컬럼을 고릅니다.

응답

성공 응답

{
  "status": 200,
  "code": null,
  "message": "수집 작업을 시작했습니다.",
  "data": {
    "jobId": 42
  }
}

이 시점의 잡 상태는 QUEUED입니다. 이어서 잡 상세 조회로 폴링하세요.

에러 응답

HTTP 상태는 항상 200이며, 아래 코드는 응답 본문의 status 값입니다.

처리 규칙

공통

• ?igsh=..., ?is_from_webapp=1, utm_source=... 등 query string 제거 후 표준 계정 링크로 정규화
• 업로드한 원본 엑셀도 GCS에 함께 보관됩니다 (재실행·디버깅용)

INSTAGRAM

• instagram-looter2 /profile 호출, 실패 시 /profile2 fallback
• 둘 다 실패하면 팔로워수 0, 프로필 필드는 빈 값
• 게시물·릴스 링크(/p/, /reel/, /tv/)는 작성자 계정을 역추출

TIKTOK

• tiktok-api23 /api/user/info 호출 (uniqueId = 핸들)
• 팔로워수는 statsV2.followerCount(문자열) 우선, 없으면 stats.followerCount
• 조회 실패 시 폴백하지 않고 해당 행을 실패 처리합니다. 팔로워수 0은 "실제로 0명"과 구분되지 않아, 틀린 값이 결과 시트에 그대로 실리는 것을 막기 위해서입니다. 실패한 행은 나머지 칸이 비고 errors 시트에 사유가 남습니다.
• 영상 링크(/@handle/video/{id})는 작성자 계정을 역추출
• 단축 링크(vt.tiktok.com/...)는 지원하지 않습니다. 리다이렉트를 따라가지 않으므로 username 파싱 실패로 errors 시트에 남습니다. 프로필 전체 URL로 올려주세요.

결과 엑셀 컬럼

시트명은 수집결과이며 컬럼 구성은 플랫폼과 무관하게 동일합니다.

실패·건너뜀이 있으면 errors 시트가 함께 생성됩니다.

API 테스트