자체 방문 통계는 항상 수집됩니다. 사용자가 공개 페이지를 어떻게 이용하는지 파악하는 데 쓰이는 Google Analytics(로그인한 워크스페이스는 제외)는 동의한 경우에만 사용됩니다. 자세한 내용은 개인정보 처리방침을 참고하세요.
작업별로 제공되는 데이터, 가격, 파라미터를 확인할 수 있습니다.
profile공개 아바타, Douyin ID, 표시 이름, 소개, 계정 통계를 조회합니다.
필수 파라미터: user_id · 단일 객체
선택 파라미터: —
user_posts공개 게시물, 게시 시각, 참여 지표(좋아요, 댓글, 공유)를 조회합니다. Douyin은 재생 수를 공개하지 않으므로 재생 필드는 항상 0이며, 이는 시청자가 없었다는 뜻이 아닙니다. 인기도는 참여 지표를 기준으로 판단합니다.
필수 파라미터: user_id · 호출당 최대 100 행
선택 파라미터: page_token, since
creator_search키워드로 계정을 찾고 지원되는 필터를 적용합니다.
필수 파라미터: keyword · 호출당 최대 20 행
선택 파라미터: follower_range, user_type
creator_audience성별, 연령, 성(省), 기기 가격대 중 지원되는 분포를 한 번에 하나씩 요청합니다.
필수 파라미터: user_id · 단일 객체
선택 파라미터: dimension
creator_trend제공되는 팔로워 변화와 추이 평균을 확인합니다.
필수 파라미터: user_id · 단일 객체
선택 파라미터: —
creator_benchmark기간별 평균과 백분위를 비교합니다.
필수 파라미터: user_id · 단일 객체
선택 파라미터: —
xingtu_creator_search상업 지수, 30일 범위, 견적을 확인합니다. Xingtu 상세 조회에는 douyin_id를 사용합니다.
필수 파라미터: keyword · 호출당 최대 20 행
선택 파라미터: —
xingtu_creator_analyticsdouyin_id의 카테고리, 주제, 공개 성과 지표를 확인합니다.
필수 파라미터: douyin_id · 단일 객체
선택 파라미터: —
xingtu_rate_card영상 길이별로 묶인 단가 구간을 확인합니다.
필수 파라미터: douyin_id · 단일 객체
선택 파라미터: —
xingtu_creator_rankings업종, 순위표, 기간을 선택해 순위 점수와 범위를 확인합니다.
필수 파라미터: industry, ranking_type, time_window · 호출당 최대 5 행
선택 파라미터: —
product_search키워드로 상품, 매장, 30일 판매량, 수수료 데이터를 검색합니다.
필수 파라미터: keyword · 호출당 최대 5 행
선택 파라미터: —
product_detail숫자형 product_id로 상품 하나의 이미지 캐러셀, 상세 이미지, 옵션, 매장, 공개 판매량 스냅샷을 조회합니다.
필수 파라미터: product_id · 단일 객체
선택 파라미터: —
live_product_search키워드로 현재 라이브 중인 상품과 해당 live_room_id를 찾습니다.
필수 파라미터: keyword · 호출당 최대 3 행
선택 파라미터: —
각 액션에는 카탈로그에 표시된 가격과 과금 규칙이 적용됩니다. 상품 금액은 원본 통화를 그대로 유지합니다.
27개 데이터 항목 전체의 제공 여부와 범위를 확인할 수 있습니다.
크리에이터, Xingtu, 상품 결과는 서로 별개의 데이터입니다. 과거 크리에이터-상품 연결 정보, 정확한 GMV 또는 ROI, 실제 구매자 프로필은 포함되지 않습니다.
크리에이터 정보
직접 제공
공개 아바타 URL을 반환합니다.
크리에이터 정보
직접 제공
내부 사용자 ID 및 Xingtu 크리에이터 ID와 구분됩니다.
크리에이터 정보
직접 제공
공개 표시 이름과 소개를 반환합니다.
크리에이터 정보
직접 제공
공개 계정 통계를 반환합니다.
오디언스
직접 제공
팔로워 또는 오디언스 분포를 반환합니다.
오디언스
직접 제공
반환된 연령대 기준으로 표시됩니다.
오디언스
직접 제공
현재 반환되는 성(省) 단위 그룹으로 표시됩니다.
오디언스
일부 제공
기기 가격대는 지원되며, 관심사와 연관 계정은 현재 제공되지 않습니다.
판매 이력
제공 불가
과거 크리에이터-상품 연결 정보는 제공되지 않습니다.
판매 이력
제공 불가
과거 홍보 카테고리 데이터는 제공되지 않습니다.
판매 이력
일부 제공
30일 범위만 유지되며, 정산 기준의 정확한 평균 주문 금액이 아닙니다.
판매 이력
제공 불가
크리에이터의 카테고리별 정산 데이터는 제공되지 않습니다.
상업 성과
일부 제공
정확한 금액이 아니라 출처에서 제공하는 범위를 반환합니다.
상업 성과
일부 제공
관련 지수와 범위를 반환하며, 주문 단위 ROI는 제공되지 않습니다.
상품 상세
직접 제공
상품 검색은 대표 이미지와 흰 배경 이미지를, 상품 상세는 이미지 캐러셀과 상세 페이지 이미지를 반환합니다. 이미지 수는 상품마다 다릅니다.
상품 상세
직접 제공
상품 검색 결과의 식별자와 링크를 반환합니다.
상품 상세
직접 제공
표시된 상품 가격을 반환하며, SKU별 가격은 없을 수 있습니다.
상품 상세
일부 제공
제공되는 카테고리 깊이까지 반환합니다. 검증한 샘플은 3단계였습니다.
상품 상세
제공 불가
구조화된 브랜드 필드는 제공되지 않습니다.
상품 상세
직접 제공
30일 판매 추이와 수집 시점의 공개 판매량 스냅샷을 반환합니다.
상품 상세
제공 불가
상품 매출 또는 GMV 필드는 제공되지 않습니다.
상품 상세
직접 제공
제공되는 경우 매장, 평점, 수수료, 협업 크리에이터 필드를 반환합니다.
구매자 프로필
제공 불가
실제 구매자의 성별 데이터는 제공되지 않습니다.
구매자 프로필
제공 불가
신뢰할 수 있는 실제 구매자 데이터는 제공되지 않습니다.
구매자 프로필
제공 불가
신뢰할 수 있는 실제 구매자 데이터는 제공되지 않습니다.
라이브 커머스
일부 제공
키워드로 현재 라이브 중인 상품을 찾아 live_room_id를 반환합니다. 특정 크리에이터의 전체 상품 목록을 제공하지는 않습니다.
데이터 연결
제공 불가
과거 크리에이터-상품 연결 정보는 제공되지 않습니다.
| 그룹 | 대상 데이터 | 현재 상태 | 근거 범위 |
|---|---|---|---|
| 크리에이터 정보 | Avatar | 직접 제공 | 공개 아바타 URL을 반환합니다. |
| 크리에이터 정보 | Douyin ID | 직접 제공 | 내부 사용자 ID 및 Xingtu 크리에이터 ID와 구분됩니다. |
| 크리에이터 정보 | 표시 이름 및 소개 | 직접 제공 | 공개 표시 이름과 소개를 반환합니다. |
| 크리에이터 정보 | 팔로워, 좋아요, 게시물 수 | 직접 제공 | 공개 계정 통계를 반환합니다. |
| 오디언스 | 성별 | 직접 제공 | 팔로워 또는 오디언스 분포를 반환합니다. |
| 오디언스 | 연령 | 직접 제공 | 반환된 연령대 기준으로 표시됩니다. |
| 오디언스 | 지역 | 직접 제공 | 현재 반환되는 성(省) 단위 그룹으로 표시됩니다. |
| 오디언스 | 기기, 관심사, 연관 계정 | 일부 제공 | 기기 가격대는 지원되며, 관심사와 연관 계정은 현재 제공되지 않습니다. |
| 판매 이력 | 과거 홍보 상품 | 제공 불가 | 과거 크리에이터-상품 연결 정보는 제공되지 않습니다. |
| 판매 이력 | 과거 홍보 카테고리 | 제공 불가 | 과거 홍보 카테고리 데이터는 제공되지 않습니다. |
| 판매 이력 | 크리에이터 평균 주문 금액 | 일부 제공 | 30일 범위만 유지되며, 정산 기준의 정확한 평균 주문 금액이 아닙니다. |
| 판매 이력 | 카테고리 평균 주문 금액 | 제공 불가 | 크리에이터의 카테고리별 정산 데이터는 제공되지 않습니다. |
| 상업 성과 | 30일 이커머스 GMV | 일부 제공 | 정확한 금액이 아니라 출처에서 제공하는 범위를 반환합니다. |
| 상업 성과 | 전환율 및 ROI | 일부 제공 | 관련 지수와 범위를 반환하며, 주문 단위 ROI는 제공되지 않습니다. |
| 상품 상세 | 대표 이미지, 흰 배경 이미지, 갤러리 이미지 | 직접 제공 | 상품 검색은 대표 이미지와 흰 배경 이미지를, 상품 상세는 이미지 캐러셀과 상세 페이지 이미지를 반환합니다. 이미지 수는 상품마다 다릅니다. |
| 상품 상세 | 상품 URL 및 ID | 직접 제공 | 상품 검색 결과의 식별자와 링크를 반환합니다. |
| 상품 상세 | 상품명 및 가격 | 직접 제공 | 표시된 상품 가격을 반환하며, SKU별 가격은 없을 수 있습니다. |
| 상품 상세 | 4단계 카테고리 경로 | 일부 제공 | 제공되는 카테고리 깊이까지 반환합니다. 검증한 샘플은 3단계였습니다. |
| 상품 상세 | 브랜드 | 제공 불가 | 구조화된 브랜드 필드는 제공되지 않습니다. |
| 상품 상세 | 판매량 | 직접 제공 | 30일 판매 추이와 수집 시점의 공개 판매량 스냅샷을 반환합니다. |
| 상품 상세 | 매출 또는 GMV | 제공 불가 | 상품 매출 또는 GMV 필드는 제공되지 않습니다. |
| 상품 상세 | 매장, 평점, 수수료 | 직접 제공 | 제공되는 경우 매장, 평점, 수수료, 협업 크리에이터 필드를 반환합니다. |
| 구매자 프로필 | 구매자 성별 | 제공 불가 | 실제 구매자의 성별 데이터는 제공되지 않습니다. |
| 구매자 프로필 | 구매자 연령 | 제공 불가 | 신뢰할 수 있는 실제 구매자 데이터는 제공되지 않습니다. |
| 구매자 프로필 | 구매자 지역 | 제공 불가 | 신뢰할 수 있는 실제 구매자 데이터는 제공되지 않습니다. |
| 라이브 커머스 | 현재 라이브 방송 상품 | 일부 제공 | 키워드로 현재 라이브 중인 상품을 찾아 live_room_id를 반환합니다. 특정 크리에이터의 전체 상품 목록을 제공하지는 않습니다. |
| 데이터 연결 | 과거 크리에이터-상품 연결 정보 | 제공 불가 | 과거 크리에이터-상품 연결 정보는 제공되지 않습니다. |
platform=douyin과 선택한 action으로 POST /api/v1/social을 호출합니다. 파라미터와 응답 필드는 API 카드에서 확인합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"douyin","action":"product_search","params":{"keyword":"립스틱","limit":5}}'
상품 검색 요청 예시