API 목록으로 돌아가기
TikTok Shop 공개 데이터

TikTok Shop API

공개 상품을 검색하고 스토어 카탈로그, 상품 상세 정보, 고객 리뷰, 크리에이터 쇼케이스를 하나의 정규화된 비동기 워크플로로 수집합니다.

사용할 수 있는 TikTok Shop API

상품 탐색과 스토어 수집부터 상품 정보 보강, 리뷰 분석, 크리에이터 상품 구성 리서치까지 작업에 맞는 API를 고르세요.

어떤 TikTok Shop 데이터를 가져올 수 있나요?

SocQ는 공개 TikTok Shop 상품·리뷰 결과를 일관된 레코드로 변환해 리서치, 모니터링, 데이터 파이프라인에 활용할 수 있게 합니다.

상품 탐색과 스토어 카탈로그

키워드와 지역으로 상품을 검색하거나, 알고 있는 TikTok Shop 스토어 URL에서 공개 카탈로그를 수집합니다.

상품·판매자 정보

제공되는 경우 상품 식별 정보, 판매자, 가격, 할인, 미디어, 카테고리, SKU 데이터, 평점, 리뷰 수, 판매 수를 가져옵니다.

공개 리뷰 데이터

노출된 경우 리뷰 텍스트, 평점, 이미지, 타임스탬프, SKU 정보, 국가, 구매 확인 여부 플래그를 수집합니다.

사용자·크리에이터 쇼케이스

공개 사용자의 Shop 쇼케이스에 진열된 상품을 수집해 상품 구성, 가격, 브랜드, 공개된 참여도를 분석합니다.

SocQ와 TikTok Shop 개발자 제품

SocQ는 지원하는 공개 데이터 수집과 정규화된 레코드에 집중합니다. 애플리케이션에 판매자 권한이나 공식 스토어·커머스 기능이 필요하다면 TikTok Shop의 공식 개발자 제품을 사용하세요.

기능SocQTikTok Shop 개발자 제품
주요 용도지원하는 공개 TikTok Shop 데이터 수집과 정규화해당 TikTok Shop 제품과 승인에 따른 공식 판매자 연동
인증SocQ API 키TikTok Shop 개발자 자격 증명과 해당 판매자 권한
스토어·커머스 작업TikTok Shop 상품과 주문을 생성·수정·게시·판매 중지·가격 설정·재고 관리·배송 처리·관리하지 않음승인된 공식 제품과 권한에 따라 다름
비공개·제한 데이터지원하지 않음공식 제품, 판매자 권한, 플랫폼 정책 범위 내로 제한
응답 형식정규화된 SocQ 레코드제품별 고유 응답

TikTok Shop API 작동 방식

5종의 엔드포인트 모두 비동기 제출, 폴링, 결과 읽기 흐름을 공유합니다.

  1. 1. 작업과 입력 선택

    엔드포인트에 따라 키워드, 공개 스토어 URL, 상품 상세 URL, TikTok 사용자 이름 중 하나로 시작합니다.

  2. 2. 제출하고 작업 ID 저장

    알맞은 엔드포인트에 입력을 보내고 선택적 지역·결과 옵션을 지정한 뒤, 반환된 task_id를 보관합니다.

  3. 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 true

TikTok 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 크레딧입니다. 빈 결과에는 결과 요금이 부과되지 않습니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.