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

틱톡 트렌드 API, 국가 코드 하나로 지금 뜨는 것 보기

··15 min read

국가 코드만 넣으면 틱톡 급상승 게시물, 사운드, 해시태그와 구글 급상승 검색어가 한 번에 와요. 핀터레스트 트렌드, 애플뮤직 차트, 프로덕트 헌트를 따로 부르는 법도 이어서 봐요.

틱톡 트렌드 API, 국가 코드 하나로 지금 뜨는 것 보기

키워드 없이 한 나라에서 지금 뜨는 것을 보고 싶다면 GET /v1/prism/trend-board?country_code=KR을 호출하세요. 틱톡 급상승 게시물, 많이 쓰인 사운드, 틱톡 인기 해시태그, 구글 급상승 검색어가 한 응답에 담겨 와요. 핀터레스트 트렌드, 애플뮤직 차트, 프로덕트 헌트는 호출이 따로예요.

호출국가 파라미터크레딧받는 것
GET /v1/prism/trend-boardcountry_code30 (고정)틱톡 급상승 게시물, 사운드, 해시태그, 구글 검색어
GET /v1/pinterest/trendscountry10핀터레스트 급상승, 시즌, 인기 검색어
GET /v1/apple_music/chartscountry1그 나라의 애플뮤직 차트
GET /v1/producthunt/launches없음1지금 소개 중인 프로덕트 헌트 제품
열린 케이스 안 트레이 네 칸에 짧은 영상 한 장, 쌓인 음반, 글자 없는 태그 핀, 검색 카드가 하나씩 놓인 트렌드 보드 일러스트

국가 코드 하나로 무엇이 돌아오나요?

틱톡 로컬 피드, 틱톡 해시태그 보드, 구글 급상승 검색어를 호출할 때마다 새로 읽어 네 섹션으로 돌려줘요. 섹션 이름은 breakout_posts, rising_sounds, rising_hashtags, rising_searches예요. 호출 사이에 아무것도 저장하지 않아서 이력은 없고 days 파라미터도 없어요. 여러 소스를 한 번에 묶어 부르는 엔드포인트이고 설명은 Prism 문서에 있어요.

bash
curl "https://www.socialcrawl.dev/v1/prism/trend-board?country_code=KR&limit=3" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"
파라미터뜻
country_code필수예요. KR, US, DE처럼 구글 트렌드가 다루는 ISO 국가 코드예요. 지원하지 않는 코드는 무료 400이에요.
period7(기본) 또는 30이에요. 틱톡 해시태그 보드를 읽는 기간이에요. 구글 급상승 검색어는 구글이 주는 가장 긴 기간인 7일로 고정이에요.
limit섹션당 행 수예요. 범위는 1~10, 기본은 10이에요.

섹션마다 기준이 정해져 있어요.

  • 급상승 게시물은 그 나라 틱톡 로컬 피드 영상 중 조회수가 작성자 본인 최근 게시물 중앙값의 3배 이상인 게시물이에요. 고정 게시물과 올린 지 48시간 안 된 게시물은 빠져요. 비교할 게시물이 8개 미만인 작성자는 건너뛰어요.
  • 급상승 사운드는 그 피드에서 가장 많이 쓰인 사운드예요. 사운드별로 첫 페이지 영상 중 최근 3일 안에 올라온 비중과 새 사운드인지 다시 뜬 사운드인지가 같이 와요.
  • 급상승 해시태그는 틱톡이 직접 내는 그 나라 해시태그 보드예요. 증가율은 일별 인기 곡선으로 계산해요. 이 보드는 27개 시장만 다뤄서 그 밖의 나라는 섹션이 비고 이유가 적혀요.
  • 급상승 검색어는 구글 트렌드의 Trending Now예요. 구글이 적은 시작 시각이 처음 뜬 시각이에요.

급상승 게시물 한 행에는 작성자, 게시물 URL, views, published_at과 함께 vs_creator가 와요. 조회수가 작성자 중앙값의 몇 배인지 보여 주는 값이에요.

json
{
  "author": "<handle>",
  "url": "https://www.tiktok.com/@<handle>/video/<id>",
  "region": "KR",
  "views": 4634696,
  "vs_creator": 3315.23,
  "author_median_views": 1398,
  "author_posts_compared": 9
}

캡션, 좋아요, 댓글 수는 이 행에 없어요. 필요하면 영상을 따로 불러요. 응답의 sources와 unavailable에서 어느 소스가 답했는지 확인하세요. 소스 하나가 실패하면 그 섹션만 비어요. 피드, 해시태그 보드, 구글 급상승 검색어가 모두 실패한 호출만 환불돼요.

캐시에 없는 보드는 로컬 피드부터 읽느라 시간이 걸려요. 클라이언트 타임아웃을 넉넉히 잡으세요. 15분 안에 같은 호출을 반복하면 캐시에서 와요.

핀터레스트 트렌드는 나라별로 어떻게 받나요?

GET /v1/pinterest/trends는 그 나라 사용자가 핀터레스트에서 무엇을 검색하는지 키워드 없이 보여 줘요. country(기본 US)와 type을 받고 limit과 상관없이 10크레딧이에요.

bash
curl "https://www.socialcrawl.dev/v1/pinterest/trends?country=KR&type=growing&limit=5" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"
type받는 것
growing(기본)가장 빨리 오르는 검색어
seasonal해마다 이맘때 돌아오는 검색어
top_monthly이번 달 가장 많이 검색된 검색어
top_yearly올해 가장 많이 검색된 검색어

항목마다 rank, term, search_index, weekly_change, monthly_change, yearly_change, seasonality, as_of가 와요. 읽을 때 알아 둘 점이 셋이에요.

  • search_index는 그 응답 안에서 0부터 100으로 맞춘 상대 검색량이에요. 검색 횟수가 아니에요.
  • 변화 필드는 비율이라 0.3이 +30%예요. 직전까지 거의 0이던 검색어는 핀터레스트가 100.01로 줘요.
  • as_of는 핀터레스트 주간 데이터의 기준일이에요. 주 단위로 공개돼서 분 단위로 최신인 목록은 아니에요.

limit 범위는 1~50, 기본은 25예요. 핀터레스트가 목록을 내는 나라는 KR, DE, GB, BR을 포함한 23곳이고 그 밖의 코드는 무료 400이에요.

높이가 서로 다른 압정 세 개가 보드에 꽂혀 있는 핀터레스트 급상승 검색어 일러스트

애플뮤직 차트는 나라마다 따로 받나요?

네, country를 바꿔 가며 불러요. GET /v1/apple_music/charts는 그 나라에서 애플뮤직으로 가장 많이 듣는 곡을 1위부터 돌려주고 1크레딧이에요. country는 대소문자 상관없이 받고 기본은 us예요.

bash
curl "https://www.socialcrawl.dev/v1/apple_music/charts?country=kr&type=songs&limit=10" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

type은 songs(기본), albums, music-videos, playlists예요. limit 범위는 1~100, 기본은 50이고 차트는 한 페이지로 끝나요. 항목은 게시물 모양이라 content.text가 제목, author.username이 아티스트, url이 애플뮤직 링크, ext.trend.rank가 순위예요. published_at은 발매일의 UTC 자정이에요. 플레이리스트에는 아티스트와 발매일이 없어요. 차트를 내지 않는 나라는 무료 400이에요. 애플이 차트를 하루에 한 번쯤 갱신하니 한 시간에 한 번 불러도 충분해요.

차트는 순위만 주고 재생 수는 주지 않아서 computed.engagement_rate와 computed.estimated_reach는 null이에요. 한 곡을 여러 플랫폼에서 같이 보려면 음악 트렌드 탐지 레시피를 참고하세요.

프로덕트 헌트는 나라 필터가 있나요?

없어요. GET /v1/producthunt/launches는 프로덕트 헌트가 지금 소개하는 제품 약 50개를 1크레딧에 돌려주는 전 세계 목록이에요. topic에 developer-tools 같은 토픽 슬러그를 넣으면 좁혀져요. query는 제품 이름과 태그라인을 걸러요.

bash
curl "https://www.socialcrawl.dev/v1/producthunt/launches?topic=developer-tools" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

제품 이름은 post.ext.title, 태그라인은 post.content.text에 오고 제품 페이지 URL, 메이커 표시 이름, post.published_at도 와요. published_at은 글을 만든 시각이라 출시일보다 몇 주 앞설 때도 있어요. 순서는 피드에 뜬 순서 그대로이고 투표 순위가 아니에요. 투표, 댓글, 메이커 핸들은 오지 않아서 engagement 필드는 모두 null이에요. 이 null을 0으로 세지 마세요. 값이 없는 자리예요.

첫 호출은 어떻게 시작하나요?

  1. 가입하고 키를 만드세요. 새 계정에는 무료 크레딧 100이 들어와요.
  2. 위의 트렌드 보드 요청에 국가 코드를 넣어 보내세요. 네 호출을 한 번씩 돌리면 42크레딧이고 그중 30이 보드예요.
  3. 코드를 쓰기 전에 익스플로러에서 응답부터 확인해 보세요. 파라미터 전체는 Prism, 핀터레스트, 애플뮤직, 프로덕트 헌트 문서에 있어요.

구글 검색어만 따로 보고 싶다면 구글 트렌드 API를 읽어 보세요.

자주 묻는 질문

국가 코드 하나로 무엇이 돌아오나요?

트렌드 보드에 country_code를 넣으면 틱톡 급상승 게시물, 급상승 사운드, 급상승 해시태그, 구글 급상승 검색어가 와요. 30크레딧 고정이에요. 핀터레스트, 애플뮤직, 프로덕트 헌트는 별도 엔드포인트라 그 응답에 없어요.

트렌드 보드에 이력이 남나요?

아니요. 호출할 때마다 새로 계산하고 호출 사이에 아무것도 저장하지 않아서 이력도 days 파라미터도 없어요. 15분 안의 같은 호출은 캐시에서 와요. 변화를 추적하려면 응답을 직접 저장하세요.

period 파라미터는 무엇을 바꾸나요?

틱톡 해시태그 보드의 기간을 7일이나 30일로 정해요. 구글 급상승 검색어는 어느 쪽을 골라도 구글이 주는 가장 긴 기간인 7일로 읽어요.

핀터레스트 트렌드와 애플뮤직 차트도 국가를 받나요?

둘 다 country로 받고 country_code는 쓰지 않아요. 기본값은 핀터레스트가 US, 애플뮤직이 us예요. 목록이나 차트를 내지 않는 나라는 무료 400이에요.

프로덕트 헌트는 국가로 거를 수 있나요?

아니요. 국가 파라미터가 없어요. topic으로 좁히거나 query로 거르세요. 투표와 댓글 수는 오지 않아요.

Topics
#틱톡-트렌드-api#실시간-트렌드#틱톡-인기#핀터레스트-트렌드#애플뮤직-차트#프로덕트-헌트

함께 읽으면 좋은 글

🤖 AI agent or LLM? Read this page as markdown