TikTok API로 크리에이터 프로필·영상 메타데이터를 읽어 소셜 통합 앱을 구축합니다.
TikTok에 앱 연결하기
앱을 TikTok에 연결하여 크리에이터 프로필을 읽고, 게시된 영상을 가져오고, Lovable 앱에서 소셜 통합을 구축하세요.
TikTok은 크리에이터 프로필과 콘텐츠에 접근할 수 있는 API를 제공하는 숏폼 비디오 플랫폼입니다. TikTok 커넥터를 사용하면 Lovable 앱에서 계정 프로필 데이터를 읽고, 영상 메타데이터에 접근하며, 특정 TikTok 계정 정보를 활용하는 크리에이터 워크플로우를 만들 수 있습니다.
이 통합은 앱 + 채팅 커넥터로 제공됩니다. 하나의 공유 연결이 빌드 중 채팅과 게시된 앱 모두에서 작동합니다.
TikTok을 연동하면 앱에서 다음과 같은 작업이 가능합니다:
- 표시 이름, 계정 ID 등 기본 프로필 데이터 읽기
- 팔로워 수, 좋아요 수, 영상 통계 조회
- 자기소개, 아바타 등 확장 프로필 정보 읽기
- 게시된 영상 목록 및 메타데이터 가져오기
TikTok 커넥터는 읽기 전용이며 OAuth를 통해 단일 TikTok 계정에 연결됩니다. 크리에이터 도구, 소셜 대시보드, 콘텐츠 포트폴리오, 특정 TikTok 계정 기반 분석 앱에 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 크리에이터 분석 대시보드 | TikTok을 사용해서 내 팔로워 수, 총 좋아요, 영상 성과를 시간대별로 보여주는 대시보드를 만들어줘. | TikTok 계정 지표를 집중적으로 보여주는 대시보드를 제공합니다. 프로필 통계와 영상 데이터를 읽어 시간 추이를 표시하고, 크리에이터가 한 곳에서 성장을 추적할 수 있게 합니다. |
| 영상 포트폴리오 사이트 | TikTok을 사용해서 내가 게시한 TikTok 영상을 제목과 조회수와 함께 보여주는 포트폴리오 페이지를 만들어줘. | 크리에이터의 TikTok 콘텐츠를 커스텀 웹사이트에 전시합니다. 게시된 영상 목록을 가져와 제목, 썸네일, 참여 지표 등과 함께 렌더링합니다. |
| 캠페인 트래커 | TikTok을 사용해서 스폰서 게시물의 TikTok 영상 메타데이터를 저장하고 캠페인 레코드와 연결하는 트래커를 만들어줘. | 연결된 TikTok 계정에 속한 캠페인 콘텐츠를 추적합니다. 게시된 영상 메타데이터를 읽어 캠페인과 매칭하고, 리포팅 데이터를 한곳에 정리해 둡니다. |
| 콘텐츠 관리 도구 | TikTok을 사용해서 게시된 TikTok 영상을 검토하고, 내부 메모를 추가하고, 캠페인별로 태깅할 수 있는 도구를 만들어줘. | 게시된 TikTok 영상 위에 가벼운 콘텐츠 관리 레이어를 구축합니다. TikTok에서 가져온 영상을 나열하고 별도 저장되는 커스텀 필드, 태그, 메모를 추가할 수 있게 합니다. |
| 프로필 동기화 유틸리티 | TikTok을 사용해서 내 TikTok 표시 이름과 계정 식별자를 CRM 레코드에 동기화하는 유틸리티를 만들어줘. | 내부 시스템을 TikTok 계정 정보와 일치시킵니다. 연결된 TikTok 계정에서 프로필 데이터를 읽어 CRM의 해당 필드에 기록해 수동 업데이트를 줄입니다. |
TikTok 연결 방법
워크스페이스 admin 또는 owner가 TikTok을 연결할 수 있습니다. 서로 다른 계정으로 여러 TikTok 연결을 만들 수 있으며, 환경을 분리하거나 여러 크리에이터를 관리할 때 유용합니다.
연결이 만들어지면 워크스페이스의 모든 프로젝트에서 TikTok을 사용할 수 있습니다. 프로젝트에서 작업하는 누구나 채팅에서 Lovable에게 프로젝트를 해당 연결에 연결해 달라고 요청할 수 있습니다.
사전 준비
TikTok을 연결하기 전에 다음을 준비하세요:
- 연결할 TikTok 계정 (OAuth 플로우 중에 새로 만들 수도 있습니다)
- Lovable 워크스페이스 owner 또는 admin 권한
이 커넥터를 통한 모든 API 요청은 TikTok 플랜에 따라 TikTok API 단위를 소비합니다. 청구와 쿼터는 Lovable이 아닌 TikTok에서 직접 처리합니다.
TikTok 연결 설정
Connectors에서 TikTok 열기
Connectors → App connectors에서 TikTok을 선택합니다.
연결 추가
Add connection을 클릭합니다.
연결 이름 지정
Display name에 연결 이름을 입력합니다(예: My TikTok). 이 이름은 Lovable 내부에서만 연결을 식별하는 용도로 사용됩니다.
Scope 검토 (선택)
Advanced settings를 펼쳐 앱이 요청할 권한을 검토합니다. 일반적인 사용 사례에 맞춰 기본 scope가 미리 선택되어 있습니다. Scope는 연결이 접근할 수 있는 데이터를 제어합니다. 네 가지 scope가 모두 기본으로 선택되어 있습니다.
필수인 Read basic profile information을 제외하면 어떤 선택적 scope든 제거할 수 있습니다.
| Scope | 설명 |
|---|---|
Read basic profile information (user.info.basic) | 표시 이름과 계정 ID |
Read user stats (user.info.stats) | 팔로워 수, 좋아요 수, 영상 수 |
Read extended profile information (user.info.profile) | 자기소개, 아바타, 프로필 세부 정보 |
Read published video metadata (video.list) | 게시된 영상 목록과 메타데이터 |
전체 scope 문서는 TikTok API scopes 레퍼런스를 참고하세요.
이 연결에 접근할 수 있는 사용자 선택
Who can access this connection에서 워크스페이스 내 누가 이 연결을 사용할 수 있는지 결정합니다:
- Only you (기본값): 연결을 만든 사람만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 본인과 명시적으로 추가된 워크스페이스 멤버만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭하면 Lovable 워크스페이스 전체에서 연결을 사용할 수 있습니다.
자세한 내용은 연결 수준 접근을 참고하세요.
TikTok에 연결하고 권한 승인
Connect를 클릭합니다. TikTok 인증 창이 열리니 브라우저에서 팝업을 차단하지 마세요. 차단되면 Lovable이 대신 리다이렉트합니다.
필요하면 TikTok에 로그인하고, 요청 권한을 검토한 뒤 Allow를 클릭합니다.
승인이 완료되면 확인과 함께 Lovable로 돌아옵니다.
연결이 완료되면 프로젝트에서 작업하는 누구나 (설정된 연결 수준 접근에 따라) 채팅에서 Lovable에게 자신의 프로젝트를 TikTok에 연결해 달라고 요청할 수 있습니다. 이후 Lovable 앱에서 TikTok 프로필 데이터와 영상 콘텐츠를 읽기 시작할 수 있습니다.
제한 사항
TikTok 커넥터는 읽기 전용입니다. 다음은 지원하지 않습니다:
- TikTok에 영상 업로드 또는 게시
- 비공개 영상 또는 초안 콘텐츠 접근
- 댓글, DM, 알림 읽기
- 팔로워 관리 또는 다른 계정과의 상호작용
- TikTok 웹훅 또는 실시간 이벤트 수신
- 최종 사용자별 TikTok 로그인 지원. 각 연결은 하나의 TikTok 계정을 나타내며, 연결된 모든 프로젝트에서 공유됩니다.
TikTok 쪽에서 인증이 해제되면 API 호출이 다시 성공하기 전에 Lovable에서 통합을 다시 연결해야 합니다.
TikTok 연결 관리
연결은 Connectors에서 관리합니다. **TikTok**을 선택한 다음 연결을 여세요.
- Unlink projects를 사용하면 다른 프로젝트에서 연결을 계속 사용할 수 있도록 유지하면서 특정 프로젝트의 TikTok 접근 권한만 제거할 수 있습니다. 단계별 절차는 연결에서 프로젝트 연결 해제를 참고하세요.
- Delete the connection을 사용하면 워크스페이스에서 연결을 완전히 제거할 수 있습니다. 삭제는 영구적이며 연결된 모든 프로젝트에서 자격 증명이 제거되고, TikTok을 사용하는 앱 기능은 새 연결을 추가할 때까지 작동하지 않습니다. 단계와 삭제 권한은 연결 삭제를 참고하세요.