100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
TikTok logo
100 크레딧 무료, 카드 등록 없이

TikTok Search Users API

API 한 번의 호출로 TikTok Search Users 데이터를 받아 가세요. Searches TikTok for user accounts matching a query, 30 per page. Each row carries the username, display name, avatar, profile URL, verification status, whether the account is private, and the follower, following, video and like counts. The search surface publishes nothing else, so on a plain call `author.bio`, `author.location`, `author.ext.bio_link` and `author.ext.business_category` are null on every row. Send `include=profile` and every row is joined, in the same call, to the profile lookup that carries them: the bio, the ISO 3166-1 alpha-2 region at `author.location`, the link in the bio and the account category land on each row. Cost: 1 credit for the page plus 1 credit per row filled from a fresh lookup (30 rows, so 31 at most); rows already in cache are filled for free, rows that could not be filled are refunded, and a repeat of the same call within the cache window is 0. Time: a plain call is about 2 seconds; `include=profile` adds 4 to 9 seconds on a fresh page (the lookups run in parallel and the call waits for the slowest, never more than 12 seconds) and nothing when the rows are already cached. `limit=N` (1 to 30) takes the top N rows of the page and, with `include`, caps the extra credits at N. The response carries a `hydration` block itemising rows, lookups, cache hits, credits and milliseconds. The counts on a search row are the search index's own figures and can trail the profile's by a few thousand on a large account; the join never overwrites a value the row already carries. Page with cursor. Send `country=` as an ISO 3166-1 alpha-2 code (KR, US, DE, …) to search for creators whose account region is that country instead of the global page: each returned row already carries `author.location`, the bio and the profile URL, the call does not paginate, and a row whose region does not match is dropped. Cost: 5 credits per in-country creator returned (8 by default, at most 20 via `limit`); unused slots are refunded. A typo is a free 400. The global 1-credit page is unchanged when `country` is omitted.

2026년 10월 업데이트SocialCrawl 팀이 직접 관리해요

검색어에 맞는 TikTok 계정을 돌려줍니다. 항목마다 username, 표시 이름, 아바타, 팔로워 수, 인증 여부가 붙고, include=profile을 붙이면 소개글, 지역, 소개 링크, 계정 카테고리까지 같은 호출 안에서 채워집니다. country에 ISO 국가 코드를 넣으면 해당 국가 계정만 반환하며, 행당 5크레딧입니다.

이름이나 주제로 계정을 찾을 때 사용하세요. 특정 국가 크리에이터가 필요하면 country=KR처럼 붙입니다. 영상 검색인 search와 search/top은 계정이 아니라 게시물을 돌려줍니다.

68개 플랫폼을 병렬로 검색합니다

·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
TikTok API

Search Users API로 무엇을 할 수 있을까요

Search Users 엔드포인트가 통합 스키마와 계산 필드를 담은 TikTok 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.

요청 예시

curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/tiktok/search/users?query=cooking&country=KR&trim=true"
import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/tiktok/search/users",
    params={
    'query': 'cooking',
    'country': 'KR',
    'trim': 'true',
    },
    headers={"x-api-key": "YOUR_API_KEY"},
)

data = response.json()
const response = await fetch(
  "https://www.socialcrawl.dev/v1/tiktok/search/users?query=cooking&country=KR&trim=true",
  {
    headers: { "x-api-key": "YOUR_API_KEY" },
  },
);

const data = await response.json();

함께 보내면 좋은 파라미터

  • trim=true 가격은 같습니다. 용량이 큰 원본 필드를 빼서 응답이 가벼워집니다.

파라미터

파라미터필수설명
query예Search keyword or phrase to find TikTok users
cursor아니오Cursor to get more users. Get 'cursor' from previous response.
trim아니오Accepted for compatibility; the response is already the canonical shape, so this flag has no effect.
include아니오Set to `profile` (one token only) to fill `author.bio`, `author.location` (the ISO region), `author.ext.bio_link` and `author.ext.business_category` on every row in this one call. Holds 1 credit per row (at most 30, or `limit`) and keeps only the rows filled from a fresh lookup; rows already in cache and rows that could not be filled are refunded, so the most a call can cost is 1 + rows. Adds 4 to 9 seconds on a fresh page (never more than 12) and nothing when the rows are already cached; read `data.hydration` for the rows, the credits held and kept, and the time. (profile)
limit아니오Take the top N rows of the page (1 to 30) after the search has run. With `include=profile` it also caps the extra credits at N: `limit=5&include=profile` costs at most 6. With `country=` it is the in-country page size (1 to 20, default 8) and the credit cap at 5 per row. On the global page it is not a page size: `next_cursor` still advances past the full page, so rows beyond N on this page are not returned by the next page.
country아니오ISO 3166-1 alpha-2 account region to filter by (KR, US, DE, …). Returns only creators whose public region is that country, 5 credits per row returned (8 by default, at most 20). Omit it for the global 1-credit page. A code this endpoint does not accept is a free 400. (US | GB | CA | AU | NZ | IE | DE | FR | ES | IT | PT | NL | BE | CH | AT | SE | NO | DK | FI | IS | PL | CZ | SK | HU | RO | BG | GR | HR | RS | SI | UA | RU | TR | IL | AE | SA | QA | KW | EG | MA | ZA | NG | KE | GH | TZ | ET | BR | MX | AR | CO | CL | PE | VE | EC | UY | PY | BO | CR | PA | DO | JM | JP | KR | CN | TW | HK | MO | SG | MY | ID | TH | VN | PH | IN | PK | BD | LK | NP | MM | KH)
응답 예시

TikTok Search Users API는 무엇을 돌려주나요

모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.

응답 예시 보기
{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/search/users",
  "data": {
    "items": [
      {
        "author": {
          "id": "user_b74616",
          "username": "user_ef0400",
          "display_name": "user_82bd81",
          "avatar_url": "https://example.com/avatars/user_821deb.png",
          "bio": null,
          "verified": false,
          "followers": 14408,
          "following": 219,
          "posts_count": 262,
          "likes_count": 74311,
          "url": "https://example.com/user_46a6c2",
          "location": null,
          "private": false
        }
      },
      {
        "author": {
          "id": "user_709cf2",
          "username": "user_c06917",
          "display_name": "user_e5d123",
          "avatar_url": "https://example.com/avatars/user_c98d93.png",
          "bio": null,
          "verified": true,
          "followers": 4989481,
          "following": 42,
          "posts_count": 673,
          "likes_count": 113375507,
          "url": "https://example.com/user_454f83",
          "location": null,
          "private": false
        }
      }
    ],
    "next_cursor": "sc2.eyJzIjoiYiIsImMiOiJzY3AuZXlKMklqb3hMQ0p4SWpwN0ltTjFjbk52Y2lJNklqTXdJaXdpYzJWaGNtTm9YMmxrSWpvaU1qQXlOakV3TURJd056STNNalEzUWpRek0wVkVOMFZDTjBJMU1FTkNNMFkyUmlKOWZRIn0",
    "total": null,
    "dropped": 0
  },
  "credits_used": 1,
  "request_id": "req_example000000",
  "cached": false,
  "pagination": {
    "next_cursor": "sc.eyJ2IjoyLCJjIjoic2MyLmV5SnpJam9pWWlJc0ltTWlPaUp6WTNBdVpYbEtNa2xxYjNoTVEwcDRTV3B3TjBsdFRqRmpiazUyWTJsSk5rbHFUWGRKYVhkcFl6SldhR050VG05WU1teHJTV3B2YVUxcVFYbE9ha1YzVFVSSmQwNTZTVE5OYWxFelVXcFJlazB3VmtWT01GWkRUakJKTVUxRlRrTk5NRmt5VW1sS09XWlJJbjAiLCJlIjoidGlrdG9rL3NlYXJjaC91c2VycyIsInAiOiJjdXJzb3IifQ",
    "has_more": true,
    "page_size": 2
  },
  "credits_remaining": 9999,
  "source": "captured",
  "captured_at": "2026-10-02T07:27:26.112Z",
  "redacted": true
}

통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.

API 상세

TikTok Search Users API는 어떻게 동작하나요

API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.

메서드

GET

응답 형식

JSON

왜 SocialCrawl인가요

TikTok Search Users 데이터는 왜 SocialCrawl로 가져올까요

TikTok 데이터 추출에서 까다로운 부분은 SocialCrawl이 가려 드려요. 통합 스키마, AI 인리치먼트, 그리고 코드에 남지 않는 플랫폼 로직까지.

개발자 우선

소셜 미디어 데이터를 몇 초 만에 수집하는 방법

개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 68개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.

모든 플랫폼을 하나의 스키마로

동일한 응답 구조로 68개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.

단순 수집을 넘어 계산된 필드 제공

엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.

코드 한 줄 쓰기 전에, 데이터부터

Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 68개 플랫폼
자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
TikTok 사용자는 API로 어떻게 찾나요?
query 파라미터에 검색어나 이름을 담아 GET /v1/tiktok/search/users를 호출하면 돼요. 핸들, 표시 이름, 팔로워 수, 아바타, 인증 여부가 담긴 매칭 계정 목록을 받아볼 수 있어요. country=KR(또는 US, DE)을 붙이면 공개 계정 지역이 그 나라인 크리에이터만 나와요.
TikTok 사용자 검색을 크리에이터 국가로 걸러볼 수 있나요?
네. country에 KR, US, DE 같은 ISO 국가 코드를 넣으면 공개 계정 지역이 그 나라인 크리에이터만 나와요. 소개와 author.location이 행에 이미 붙어 있고, 기본 8명, limit으로 최대 20명이에요. 영상 검색의 region과는 달라요. 그쪽은 프록시 위치만 바꾸고 크리에이터를 나라로 거르지 않아요.
사용자 검색 응답에는 어떤 필드가 담기나요?
사용자 id, 핸들, 표시 이름, 아바타 URL, 프로필 URL, 팔로워 수, 팔로잉 수, 영상 수, 좋아요 수, 인증 여부가 통합 스키마 JSON으로 정리되어 응답돼요. 소개글, 지역, 소개 링크, 계정 카테고리는 검색 화면이 공개하지 않아 기본 호출에서는 null이고, include=profile을 붙이면 같은 호출 안에서 프로필 조회로 채워져요.
사용자 검색 결과를 이어서 받으려면요?
응답의 cursor 값을 다음 요청의 cursor 파라미터에 넣어 주세요. cursor가 0이나 비어 있을 때까지 반복하면 해당 키워드의 매칭 계정을 모두 받아볼 수 있어요.
인증된 TikTok 크리에이터만 고를 수 있나요?
네, 응답에 verified 불리언이 포함돼요. 클라이언트에서 verified=true인 결과만 필터링하시면 해당 키워드의 인증 크리에이터 목록을 바로 받아보실 수 있어요.
계정마다 소개글과 지역도 같은 호출에서 받을 수 있나요?
네. include=profile을 붙이면 페이지의 모든 행이 같은 호출 안에서 프로필 조회와 합쳐져서, 소개글, author.location의 두 글자 지역 코드, 소개 링크, 계정 카테고리가 행마다 따로 요청하지 않아도 채워져요. 행이 이미 갖고 있던 수치는 그대로 유지돼요. 이미 캐시에 있는 행은 무료로 채워지고, 채우지 못한 행은 환불되면서 _warnings에 표시되며, 응답의 hydration 블록에서 조회한 행, 채운 행, 캐시로 채운 행, 잡아 둔 크레딧과 실제 쓴 크레딧, 추가된 밀리초를 확인할 수 있어요. limit으로 상위 N행만 받으면서 추가 크레딧도 함께 제한할 수 있어요.
이 엔드포인트는 요금이 얼마인가요?
기본 호출은 한 번에 1 크레딧이 소진돼요(스탠다드 티어). 한 페이지에 담기는 사용자 수와 상관없이 비용은 동일해요. include=profile을 붙이면 행마다 크레딧 하나를 더 잡아 두고 새로 조회해 채운 행에만 남기므로, 99개 계정이 담긴 한 페이지는 최대 100 크레딧이에요. 이미 캐시에 있는 행은 무료이고 채우지 못한 행은 환불되며, limit으로 행 수와 추가 크레딧을 함께 제한할 수 있어요. 새 계정에는 100 크레딧이 무료로 들어가요.

AI에게 SocialCrawl을 물어보세요

TikTok Search Users 데이터, 가져올 준비 되셨어요?

API 키 받고 60초 안에 TikTok 데이터를 받아 가세요.

무료로 시작하기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요