틱톡 유저 검색, KR 3건 전부 한국 · 15크레딧

틱톡 유저 검색에 country=KR을 붙이면 3행이 전부 한국이었어요. GET /v1/tiktok/search/users?query=cooking&country=KR&limit=3을 2026-09-17에 쳤더니 바이오는 3/3이었고 15크레딧이 나갔어요. 커서는 없었어요. country만 빼면 1크레딧이고 location은 null이에요. 같은 분(UTC 23:58–23:59)에 찍은 라이브 호출 5개를 보여 드려요.

틱톡 아이디 검색, 한국 공개 계정만 어떻게 받나요?

키워드로 틱톡 아이디 검색을 치고 country=KR을 붙이면 공개 계정 지역이 KR인 행만 받아요. 이미 아는 핸들로 본인 계정을 찾는 「틱톡 아이디 찾기」가 아니에요. 틱톡 크리에이터 검색을 한국 캠페인용으로 자를 때 쓰는 최소 호출이에요.

curl -s --max-redirs 0 -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  -H "Cache-Control: no-cache" -H "Pragma: no-cache" \
  "https://www.socialcrawl.dev/v1/tiktok/search/users?query=cooking&country=KR&limit=3"

{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/search/users",
  "credits_used": 15,
  "credits_remaining": 90136,
  "cached": false,
  "request_id": "req-EZsguJxPPoP6LtHq",
  "pagination": { "next_cursor": null, "has_more": false, "page_size": 3 },
  "data": {
    "dropped": 0,
    "total": 3,
    "items": [
      { "author": { "username": "bear_wife12", "display_name": "bear_wife", "location": "KR", "bio": "Breakfast for husband series 🌞\nbreakfast ideas💡👍", "followers": 50558, "verified": false } },
      { "author": { "username": "bing_oii", "display_name": "빙이", "location": "KR", "bio": "집순이의 집밥", "followers": 25877, "verified": false } },
      { "author": { "username": "leoniecadao", "display_name": "Leonie", "location": "KR", "bio": "becoming.\n☁️💫🪽\nxoxo", "followers": 27045, "verified": false } }
    ]
  }
}

세 행은 bear_wife12(bear_wife, 팔로워 50,558), bing_oii(빙이, 25,877, 집순이의 집밥), leoniecadao(Leonie, 27,045)예요. location은 KR/KR/KR이었고 바이오는 3/3이었어요. include=profile은 안 붙였어요. location=KR은 공개 계정 지역이지 국적이 아니에요. 표시 이름이 Leonie인 leoniecadao도 KR이었어요.

틱톡 계정 검색에서 country=KR은 무엇을 거르나요?

틱톡 계정 검색의 country는 ISO 3166-1 alpha-2예요. 공개 계정 지역이 그 코드인 행만 남겨요.

1. 유저 검색 country는 공개 계정 지역 필터예요.
2. 영상 검색 region은 이번 호출에서 치지 않았어요. 공식 region_code도 영상용이에요.
3. 글로벌 include=profile의 author.location 라벨은 필터가 아니에요. 이번 세션에서는 부르지 않았어요.

틱톡 개발자 허브에는 키워드와 국가를 같이 거는 상업 유저 검색이 없어요. 틱톡 One은 로그인 콘솔에서 크리에이터 나라와 오디언스 나라를 따로 걸러요.

같은 틱톡 계정 검색을 country=US&limit=3으로 치면 3행이 전부 US였어요. 15크레딧이 나갔고 커서는 없었어요. 바이오는 2/3이었고 universal_truther는 null이에요. 국가 모드라도 바이오가 항상 있는 건 아니에요.

bing_oii 프로필은 location이 KR이고 바이오는 집순이의 집밥이었어요. computed.language: ko였고 1크레딧이었어요. 팔로워는 검색 25,877, 프로필 25,907이에요. 검색 숫자는 수십 명 뒤처질 수 있어요.

틱톡 한국 크리에이터를 고를 때 쓰는 축은 계정 지역이에요. 앱 GPS 「근처」와는 달라요.

country를 빼면 틱톡 유저 찾기는 어떻게 달라지나요?

country를 빼면 틱톡 유저 찾기는 예전 글로벌 페이지예요. GET /v1/tiktok/search/users?query=cooking&limit=5는 HTTP 200에 5행이 왔고 1크레딧이었어요. location은 null ×5, bio도 null ×5였고 has_more: true였어요. cookming_, cookingwithshereen, albert_cancook, cookinwithmegg, holmescooking은 국가 표본이 아니에요.

같은 분이고, 쿼리는 query=cooking이에요.

문서상 국가 모드 기본은 8행이고 limit 최대는 20이에요. 이번 호출은 limit=3만 썼어요. 국가 모드는 1크레딧이 아니고, 기본 30건도 아니에요. 30은 글로벌 쪽이고, 글로벌은 커서가 붙어요.

국가 모드 틱톡 유저 검색은 몇 크레딧인가요?

반환 행 × 5예요. KR은 3×5=15, US도 3×5=15였어요. 안 쓴 슬롯은 문서상 환불돼요. 이번엔 3을 요청해 3이 와서 15를 냈어요. 글로벌 페이지는 1크레딧이고 프로필도 1크레딧이에요.

country=ZZ는 72ms 만에 HTTP 400 INVALID_REQUEST가 났고 credits_used: 0이었어요. 메시지에 허용 ISO-2 목록이 있고 KR, US가 들어 있어요.

{
  "success": false,
  "error": {
    "type": "INVALID_REQUEST",
    "status": 400,
    "message": "Invalid value for 'country': 'ZZ'. Allowed values: US, GB, CA, …, KR, …, KH."
  },
  "credits_used": 0,
  "credits_remaining": 90135,
  "request_id": "req-ie5mzqaOMywjuJvf"
}

이번 다섯 호출은 15+1+0+15+1=32예요. 잘못된 코드가 과금되지는 않아요. KR·US 모두 has_more: false, next_cursor: null이었어요. 국가 모드에 cursor는 없어요.

어떻게 시작하나요?

키를 받으면 가장 작은 첫 호출은 아래예요. SocialCrawl API 키는 x-api-key 헤더로 넣어요.

curl -s --max-redirs 0 -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  -H "Cache-Control: no-cache" -H "Pragma: no-cache" \
  "https://www.socialcrawl.dev/v1/tiktok/search/users?query=cooking&country=KR&limit=3"

행과 핸들은 바뀌어요. 돌아온 행의 author.location은 여전히 KR이어야 하고, credits_used는 5 × 행 수여야 해요. 오리진은 https://www.socialcrawl.dev로 두고, 리다이렉트는 따라가지 마세요.

코드 한 줄 쓰기 전에 데이터를 먼저 보려면 비주얼 익스플로러에 같은 경로를 넣어 보세요. 엔드포인트 목록은 틱톡 허브에 있고, 호출 방법은 문서에 있어요. 크레딧 밀도는 틱톡 API 1크레딧에 더 받기에 따로 적었어요. 이 글은 search/users의 country만 다뤄요.

자주 묻는 질문

country=KR로 틱톡 유저 검색하면 크레딧이 얼마나 드나요?

반환 행 × 5예요. 2026-09-17에 limit=3으로 3행이 와서 15크레딧이었어요. 안 쓴 슬롯은 문서상 환불돼요. 이번엔 3을 요청해 3이 왔어요. 글로벌 페이지 1크레딧과는 식이 달라요.

country=KR은 공개 계정 지역이 한국인 계정만 주나요?

이번 캡처 3행은 전부 author.location=KR이었어요. 시청자 지역도, 촬영지도, 국적도 아니에요. 공개 계정 지역 필터예요.

country와 영상 검색의 region은 같은 파라미터인가요?

아니에요. country는 유저 검색의 계정 지역 필터예요. 영상 region은 이번 호출에서 치지 않았어요. country는 프록시 로케일도, 언어 필터도 아니에요.

잘못된 국가 코드는 과금되나요?

country=ZZ는 HTTP 400 INVALID_REQUEST였고 credits_used는 0이었어요. 빗나간 코드는 빈 페이지 과금이 아니라 공짜 400이에요.

국가 모드에도 cursor가 있나요?

없어요. KR·US 모두 next_cursor: null, has_more: false였어요. 한 방이에요. country를 빼야 글로벌 커서가 붙어요.