SocQ는 이미 공개 TikTok 프로필, 동영상, 댓글, 검색, 해시태그를 지원하고 있으며, 이 내용은 TikTok 스크래핑 가이드에서 다룹니다. 2026-11-17에는 TikTok 엔드포인트 14개가 TikTok 플랫폼 페이지에 추가로 공개되었습니다. 기본 엔드포인트로는 답할 수 없던 질문, 즉 크리에이터의 팔로워가 어디에 사는지, 동영상 조회수가 진짜인지, 오늘 사람들이 무엇을 검색하는지, 지금 LIVE 방송에서 무엇을 팔고 있는지에 답해 줍니다.
이 가이드에서는 신규 엔드포인트를 용도별로 묶어 각각의 요청 예시 하나와 가격, 사용 시점을 정리합니다.
빠른 답변: 모든 엔드포인트는 JSON 본문을 담아
https://api.socq.ai/v1/tiktok/<endpoint>로 보내는POST요청입니다. 호출하면task_id가 반환되며,status가succeeded가 될 때까지GET /v1/tasks/{task_id}를 폴링한 뒤data.results.items를 읽으세요.
신규 TikTok 엔드포인트 한눈에 보기
1 SocQ 크레딧 = $0.005입니다. 결과 단위로 과금되는 엔드포인트는 기본 요금이 없으므로 결과가 비어 있으면 비용이 들지 않습니다.
| 엔드포인트 | 반환 내용 | 가격 |
|---|---|---|
| TikTok Audience Demographics API | 팔로워 국가별 비율과 표본 수 | 호출당 20 크레딧($0.10) |
| TikTok Fake Views Checker API | 가짜 조회수 점수, 추정 가짜 조회수와 비율, 트래픽 등급, 주요 원인 | 호출당 5 크레딧($0.025) |
| TikTok Similar Accounts API | TikTok이 유사 계정으로 추천하는 계정과 소개글, 각종 수치 | 계정당 0.5 크레딧($0.0025) |
| TikTok Reposts API | 계정이 리포스트한 동영상과 원작자, 통계 | 동영상당 0.5 크레딧($0.0025) |
| TikTok Playlists API | 공개 재생목록의 이름, 커버, 동영상 수 | 재생목록당 0.5 크레딧($0.0025) |
| TikTok Trending Searches API | 오늘의 트렌드 검색어 약 100개와 순위 | 호출당 0.5 크레딧($0.0025) |
| TikTok Creator Search Insights API | 인기 검색어 20개와 인기도 점수, 7개 지점 추세 | 호출당 1 크레딧($0.005) |
| TikTok Hashtag Views API | 해시태그 최대 20개의 총 동영상 수와 조회수 | 해시태그당 0.5 크레딧($0.0025) |
| TikTok Comment Keywords API | 순위가 매겨진 댓글 키워드와 해당 댓글 | 호출당 1 크레딧($0.005) |
| TikTok Sound Search API | 아티스트, 길이, 미리 듣기, 사용 횟수를 포함한 사운드 | 사운드당 0.6 크레딧($0.003) |
| TikTok Photo Search API | 모든 이미지와 참여 지표를 포함한 사진 캐러셀 게시물 | 게시물당 0.6 크레딧($0.003) |
| TikTok Live Search API | 지금 방송 중인 LIVE와 호스트, 시청자 수, 좋아요 수 | 방송당 0.6 크레딧($0.003) |
| TikTok Live Ranking API | LIVE 일간 랭킹의 호스트 최대 99명과 선물 기반 점수 | 호출당 0.5 크레딧($0.0025) |
| TikTok Live Shopping API | LIVE 방송 쇼핑백의 상품과 가격, 판매 수량 | 상품당 0.1 크레딧($0.0005) |
인증과 비동기 작업 흐름
모든 요청은 API 키로 인증합니다. 작업 제출, 작업 상태 조회, 결과 요청에 같은 헤더를 사용합니다.
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
모든 수집은 백그라운드 작업으로 실행됩니다.
submit -> task_id -> queued -> running -> succeeded
\-> failed
제출 호출은 data.task_id와 data.status를 즉시 반환합니다. 이 ID로 작업을 폴링하세요.
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
status가 succeeded이면 응답에 result_count, credits_amount, 그리고 data.results.items에 담긴 정규화된 레코드의 첫 페이지가 포함됩니다. limit의 기본값은 50이고 최대 500까지 지정할 수 있습니다. results.has_more가 true이면 results.next_cursor를 cursor로 넘겨 다음 페이지를 읽으세요. 실패한 작업에는 error_message가 들어 있습니다.
아래의 모든 제출 본문에 선택 항목인 callback_url을 추가할 수 있습니다. 그러면 작업이 끝났을 때 SocQ가 작업 요약을 담은 POST를 한 번 보내며, 레코드는 작업 엔드포인트에서 읽으면 됩니다. 클라이언트 측 타임아웃이 발생해도 작업은 취소되지 않으므로, 다시 제출하지 말고 같은 작업 ID로 조회를 이어가세요. 402는 계정의 크레딧이 부족하다는 뜻이고, 429는 키가 속도 또는 크레딧 한도에 도달했다는 뜻입니다.
계약 전에 크리에이터 검증하기
이 다섯 개 엔드포인트는 크리에이터와 계약할 가치가 있는지 판단하는 데 도움이 됩니다.
Audience Demographics는 팔로워 표본에 포함된 모든 국가를 비율과 해당 표본 팔로워 수와 함께 큰 순서대로 나열합니다. 크리에이터의 도달 범위가 판매 대상 시장에 닿는지 확인할 때 사용하세요. username은 @를 붙여도, 붙이지 않아도 됩니다. (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame"}'
Fake Views Checker는 동영상 또는 사진 게시물 URL을 받아 fake_score, is_suspicious, confidence_level, estimated_fake_views, fake_view_percentage, estimated_organic_views, traffic_tier, main_reason을 반환합니다. 선택 항목인 category(기본값 general, 또는 entertainment, education, product, verified_large)로 참여 지표 벤치마크를 고릅니다. 협찬 게시물이나 도달 범위를 보고 비용을 지불하려는 크리에이터에게 실행해 보세요. (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/fake-views" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
Similar Accounts는 TikTok이 직접 특정 사용자 이름과 유사하다고 추천하는 계정을 TikTok의 순서대로 반환하며, 소개글, 팔로워 수, 동영상 수, 인증 여부가 함께 제공됩니다. 효과가 좋았던 크리에이터가 있다면 그 주변으로 후보 목록을 넓힐 수 있습니다. results_limit의 기본값은 30입니다(1~300). (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/similar-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame", "results_limit": 30}'
Reposts는 계정이 자기 업로드 외에 무엇을 퍼뜨리는지 보여 줍니다. 리포스트한 각 동영상을 원작자, 캡션, 조회수, 좋아요 수, 해시태그, 동영상 파일과 함께 최신순으로 반환합니다. results_limit의 기본값은 20입니다(1~500). (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "mrbeast", "results_limit": 20}'
Playlists는 크리에이터의 공개 재생목록을 이름, 커버, item_count와 함께 나열합니다. 크리에이터가 꾸준히 이어 가는 시리즈와 포맷을 파악할 수 있습니다. results_limit의 기본값은 20입니다(1~100). (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/user-playlists" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "zachking"}'
크리에이터 한 명을 Audience Demographics, 최근 동영상 3개에 대한 Fake Views, 유사 계정 30개로 전부 점검하면 20 + 15 + 15 = 50 크레딧($0.25)이 듭니다.
사람들이 검색하고 이야기하는 주제 찾기
Trending Searches는 입력 없이 오늘의 트렌드 검색어 약 100개를 TikTok의 순서대로 반환하며, 각 항목에 검색 링크가 붙습니다. 목록이 매일 갱신되므로 아침마다 콘텐츠 아이디어를 얻는 피드로 쓰기 좋습니다. (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/trending-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Creator Search Insights는 인기 검색어 20개를 반환하며, 각 항목에 0~100의 인기도 점수, 7개 지점 추세, 관련 동영상 수, 카테고리, 라벨이 포함됩니다. 모든 필드는 선택 항목입니다. language(기본값 en, 그 밖에 ar, de, es, fr, id, ja, ko, pt, th, tr, vi), category(fashion, food, gaming, science, sports, tourism), filter_by를 지정할 수 있습니다. 수요는 있지만 아직 동영상이 적은 검색어를 찾으려면 filter_by를 content_gap으로 설정하세요. (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/search-insights" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"language": "en", "category": "food", "filter_by": "content_gap"}'
Hashtag Views는 요청 한 번으로 해시태그를 최대 20개까지 총 동영상 수와 총 조회수로 비교합니다. 존재하지 않는 태그는 건너뛰며 과금되지 않습니다. (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags": ["cooking", "booktok"]}'
Comment Keywords는 댓글이 많은 게시물의 댓글란을 대신 읽어 줍니다. 가장 자주 나오는 키워드를 순위대로 반환하며, 각 키워드에는 이를 언급한 댓글과 그 좋아요 수가 함께 제공됩니다. (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/comment-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
TikTok이 검색어 아래에 보여 주는 검색 결과는 TikTok Top Search 가이드를 참고하세요.
사운드와 사진 게시물 검색하기
Sound Search는 제목, 아티스트, 분위기로 사운드 라이브러리를 검색해 사운드 ID, 아티스트, 커버, 길이, 재생 가능한 미리 듣기, metrics.videos_count를 반환합니다. sort_by는 relevance(기본값), most_used, latest 중 하나이며, region의 기본값은 US입니다. 반환된 ID는 TikTok Song Videos에 사용하거나 TikTok 음악 차트 가이드의 차트와 비교해 보세요. results_limit의 기본값은 20입니다(1~500). (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/search-music" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "lofi", "results_limit": 20}'
Photo Search는 사진 캐러셀 게시물만 반환하며, 캐러셀의 모든 이미지와 함께 캡션, 작성자, 해시태그, 조회수, 좋아요 수, 댓글 수, 공유 수를 제공합니다. results_limit의 기본값은 20입니다(1~500). (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/search-photos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "outfit ideas", "results_limit": 20}'
TikTok LIVE와 LIVE 쇼핑 지켜보기
Live Search는 요청 시점에 방송 중인 라이브를 찾아 제목, 호스트, 현재 시청자 수, 좋아요 수, 시작 시각을 반환합니다. results_limit의 기본값은 20입니다(1~200). (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/search-live" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "deals", "results_limit": 20}'
Live Shopping은 방송 쇼핑백에 담긴 상품을 제목, 현재 가격, 판매 수량, 판매자, 이미지와 함께 나열합니다. Live Search 결과의 id와 author.id가 이 엔드포인트가 받는 room_id와 user_id이므로, 방송이 아직 진행 중일 때 호출하세요. results_limit의 기본값은 100이며(1~500), 상품이 없는 방송은 과금되지 않습니다. (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id": "7704767945901132575", "user_id": "7153432386608251946", "results_limit": 100}'
Live Ranking은 입력 없이 현재 LIVE 일간 랭킹의 호스트를 최대 99명까지 순위, 선물 기반 점수, 사용자 이름, 팔로워 수와 함께 반환합니다. (문서)
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
특정 계정이 라이브 중인지 확인하려면 TikTok 라이브 상태 가이드의 엔드포인트를 사용하세요.
관련 TikTok 가이드
TikTok Creative Center의 광고와 크리에이터 단가는 TikTok Creative Center API 가이드에서, 새로운 TikTok Shop 엔드포인트는 TikTok Shop 상품 리서치 가이드에서 다룹니다. SocQ를 다른 제공업체와 비교하려면 TikTok 스크래퍼 API 베스트 7과 TikTok API 대안을 읽어 보세요.
자주 묻는 질문(FAQ)
계정에 리포스트나 재생목록이 없어도 과금되나요?
아니요. 결과 단위로 과금되는 엔드포인트는 기본 요금이 없으며, 문서에도 결과가 비어 있으면 과금되지 않는다고 명시되어 있습니다.
Fake Views Checker는 무엇을 기준으로 가짜를 판단하나요?
category에서 선택한 콘텐츠 유형의 벤치마크와 동영상의 참여 지표를 비교해 점수, 추정 가짜 조회수와 그 비율, 트래픽 등급, 주요 원인을 반환합니다. 최종 판정이 아니라 검토가 필요한 추정치로 보세요.
Live Shopping에 넣을 room_id와 user_id는 어디서 얻나요?
TikTok Live Search에서 얻습니다. 결과의 id가 room_id이고 author.id가 user_id입니다. 방송이 아직 진행 중이어야 합니다.
Trending Searches와 Creator Search Insights는 어떻게 다른가요?
Trending Searches는 TikTok이 순위를 매긴 오늘의 검색어 약 100개 목록이며 0.5 크레딧입니다. Creator Search Insights는 인기도 점수와 7개 지점 추세가 포함된 검색어 20개를 반환하고, 언어, 카테고리, 콘텐츠 갭으로 필터링할 수 있으며 1 크레딧입니다.
TIKTOK API
공개 TikTok URL로 워크플로를 테스트하세요
공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.
TikTok API 살펴보기