TikTok Shop API
공개 상품을 검색하고 스토어 카탈로그, 상품 상세 정보, 고객 리뷰, 크리에이터 쇼케이스를 하나의 정규화된 비동기 워크플로로 수집합니다.
사용할 수 있는 TikTok Shop API
상품 탐색과 스토어 수집부터 상품 정보 보강, 리뷰 분석, 크리에이터 상품 구성 리서치까지 작업에 맞는 API를 고르세요.

tiktok-shop/search
검색결과당 0.7 크레딧

tiktok-shop/products
상품결과당 0.7 크레딧

tiktok-shop/product
게시물결과당 0.7 크레딧

tiktok-shop/product-reviews
댓글결과당 0.3 크레딧

tiktok-shop/user-showcase
상품결과당 0.7 크레딧

tiktok-shop/hot-products
상품결과당 0.5 크레딧

tiktok-shop/categories
상품요청당 0.5 크레딧

tiktok-shop/category-products
상품결과당 0.5 크레딧

tiktok-shop/search-suggestions
검색요청당 0.5 크레딧
어떤 TikTok Shop 데이터를 가져올 수 있나요?
SocQ는 공개 TikTok Shop 상품·리뷰 결과를 일관된 레코드로 변환해 리서치, 모니터링, 데이터 파이프라인에 활용할 수 있게 합니다.
상품 탐색과 스토어 카탈로그
키워드와 지역으로 상품을 검색하거나, 알고 있는 TikTok Shop 스토어 URL에서 공개 카탈로그를 수집합니다.
상품·판매자 정보
제공되는 경우 상품 식별 정보, 판매자, 가격, 할인, 미디어, 카테고리, SKU 데이터, 평점, 리뷰 수, 판매 수를 가져옵니다.
공개 리뷰 데이터
노출된 경우 리뷰 텍스트, 평점, 이미지, 타임스탬프, SKU 정보, 국가, 구매 확인 여부 플래그를 수집합니다.
사용자·크리에이터 쇼케이스
공개 사용자의 Shop 쇼케이스에 진열된 상품을 수집해 상품 구성, 가격, 브랜드, 공개된 참여도를 분석합니다.
SocQ와 TikTok Shop 개발자 제품
SocQ는 지원하는 공개 데이터 수집과 정규화된 레코드에 집중합니다. 애플리케이션에 판매자 권한이나 공식 스토어·커머스 기능이 필요하다면 TikTok Shop의 공식 개발자 제품을 사용하세요.
| 기능 | SocQ | TikTok Shop 개발자 제품 |
|---|---|---|
| 주요 용도 | 지원하는 공개 TikTok Shop 데이터 수집과 정규화 | 해당 TikTok Shop 제품과 승인에 따른 공식 판매자 연동 |
| 인증 | SocQ API 키 | TikTok Shop 개발자 자격 증명과 해당 판매자 권한 |
| 스토어·커머스 작업 | TikTok Shop 상품과 주문을 생성·수정·게시·판매 중지·가격 설정·재고 관리·배송 처리·관리하지 않음 | 승인된 공식 제품과 권한에 따라 다름 |
| 비공개·제한 데이터 | 지원하지 않음 | 공식 제품, 판매자 권한, 플랫폼 정책 범위 내로 제한 |
| 응답 형식 | 정규화된 SocQ 레코드 | 제품별 고유 응답 |
TikTok Shop API 작동 방식
5종의 엔드포인트 모두 비동기 제출, 폴링, 결과 읽기 흐름을 공유합니다.
1. 작업과 입력 선택
엔드포인트에 따라 키워드, 공개 스토어 URL, 상품 상세 URL, TikTok 사용자 이름 중 하나로 시작합니다.
2. 제출하고 작업 ID 저장
알맞은 엔드포인트에 입력을 보내고 선택적 지역·결과 옵션을 지정한 뒤, 반환된 task_id를 보관합니다.
3. 폴링하고 결과 읽기
완료될 때까지 /v1/tasks/{task_id}를 폴링하고, data.results.items를 읽고, has_more가 true인 동안 next_cursor를 따라갑니다.
SocQ API 키로 인증하고 상품 키워드를 제출합니다. 스토어 URL, 상품 URL, TikTok 사용자 이름이 이미 있다면 다른 엔드포인트를 사용하세요.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"running shoes","results_limit":100,"region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTikTok Shop 주요 활용 사례
상품·트렌드 리서치
키워드와 시장으로 공개 상품을 찾아 상품 구성, 가격대, 공개된 수요 신호를 비교합니다.
스토어·경쟁사 모니터링
공개 스토어 카탈로그 스냅샷을 수집해 등록 상품, 가격, 할인, 상품 구성의 변화를 시간순으로 추적합니다.
상품·리뷰 분석
상품 상세 정보를 공개 평점, 리뷰 텍스트, 이미지, SKU 정보, 구매 확인 여부 플래그와 결합해 분석합니다.
크리에이터 상품 구성 리서치
공개 크리에이터 쇼케이스를 수집해 소개된 상품, 판매자, 브랜드, 가격, 공개된 참여도를 분석합니다.
제한 사항과 공개 데이터 정책
TikTok Shop 결과는 특정 시점의 공개 레코드이며, 지역, 노출 여부, 제공 가능 여부, 원본 범위에 따라 달라집니다.
- 이 API는 공개 데이터만 수집합니다. 비공개, 삭제됨, 이용 불가, 지역 제한이 있는 상품과 리뷰는 레코드가 생성되지 않을 수 있습니다.
- 지원되는 경우 지역 기본값은 US입니다. 상품 제공 여부, 가격, 순위, 리뷰 노출은 시장에 따라 다를 수 있으며 수집 이후에도 바뀔 수 있습니다.
- results_limit은 상한일 뿐 보장된 결과 수가 아닙니다. 원본에서 노출하지 않는 경우 판매자, 가격, 미디어, SKU, 리뷰, 구매 확인 여부 필드는 비어 있을 수 있습니다.
- SocQ는 읽기 전용 공개 데이터 서비스이며 TikTok 공식 API가 아닙니다. 상품 등록, 리뷰, 쇼케이스, 재고, 가격, 배송, 풀필먼트 설정을 변경하지 않습니다.
TikTok Shop API 자주 묻는 질문
TikTok Shop API란 무엇인가요?
TikTok Shop API는 공개 상품, 스토어 카탈로그, 상품 상세 정보, 리뷰, 크리에이터 쇼케이스를 검색하고 수집하는 SocQ API 모음입니다. SocQ는 지원하는 결과를 분석과 데이터 워크플로에 쓸 수 있도록 일관된 레코드로 변환합니다.
어떤 TikTok Shop API를 사용해야 하나요?
키워드 중심 탐색은 Search, 공개 스토어 카탈로그는 Products, 알고 있는 상품 하나는 Product, 고객 의견은 Product Reviews, 공개 TikTok 사용자나 크리에이터가 진열한 상품은 User Showcase를 사용하세요.
TikTok 계정을 연결해야 하나요?
고객의 TikTok OAuth는 필요하지 않습니다. 요청은 SocQ API 키로 인증합니다. SocQ는 TikTok 공식 API가 아니며 지원하는 공개 데이터에만 접근합니다.
TikTok Shop API 사용 요금은 어떻게 되나요?
반환된 Search, Products, Product, User Showcase 레코드는 1건당 0.7 SocQ 크레딧입니다. 저장된 Product Reviews 레코드는 1건당 0.3 크레딧입니다. 빈 결과에는 결과 요금이 부과되지 않습니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
YouTube API
지원되는 공개 YouTube 채널 프로필, 동영상 상세 정보, 채널 동영상, 댓글, 쇼츠, 키워드·해시태그 결과, 제공되는 스크립트를 하나의 정규화된 비동기 워크플로로 수집합니다.
Facebook API
공개 Facebook 페이지 프로필, 게시물, 그룹 게시물, 댓글, 키워드에 일치하는 이벤트, 가져올 수 있는 동영상 스크립트를 수집합니다. 식별 정보, 콘텐츠, 출처, 형식, 장소, 미디어, 반응, 참석, 참여도 필드는 정규화되어 제공됩니다.
X API
공개 프로필, 팔로워·팔로잉 관계, 게시물, 답글, 인용, 리포스트한 사용자, 검색 결과, 현재 트렌드를 수집합니다. 일관된 결과를 리서치와 모니터링에 활용하세요.
LinkedIn API
알고 있는 URL에서 공개 LinkedIn 프로필, 기업, 게시물, 채용 공고 데이터를 가져옵니다. 식별 정보, 경력, 기업, 콘텐츠, 참여도, 채용 공고 필드가 정규화되어 제공됩니다.
Reddit API
알고 있는 URL에서 공개 Reddit 게시물과 댓글을 가져오고, 서브레딧의 새 글·인기 글·핫 게시물을 둘러보거나, 키워드와 게시 기간으로 토론을 검색합니다.
Pinterest API
공개 Pinterest 프로필 데이터를 가져오고, 알고 있는 핀을 확인하고, 선택한 프로필의 핀을 수집하거나 키워드로 검색해 크리에이터, 콘텐츠, 비주얼 트렌드를 리서치합니다.