틱톡 트렌드 API, 국가 코드 하나면 지금 뜨는 게 돌아와요

틱톡 트렌드 API는 국가 코드 KR로 그 나라의 급상승 게시물, 사운드, 해시태그, Google 검색어를 한 응답에 담아요. 2026-10-05 00:53 KST 호출은 30크레딧에 게시물 0건과 나머지 섹션 각 3개였고, Pinterest, Apple Music, Product Hunt는 그 응답에 없어요.

국가 코드 하나로 지금 뭐가 돌아오나요?

같이 온 것은 TikTok과 Google 검색어예요. 급상승 게시물은 0건이고, 사운드, 해시태그, Google 검색어는 각 3개예요. unavailable는 빈 배열이라, 이번 응답에서 빠졌다고 표시된 섹션은 없었어요. 음악 차트와 Pinterest 검색어는 이 JSON에 없어요. 응답 method는 그 두 소스가 아직 이 보드에 없다고 적고, 언어 모델로 순위를 매기지도 않는다고 해요.

2026-10-04 15:53:05 UTC에 country_code=KR과 limit=3만 넣고 트렌드 보드를 불렀어요. 한국 시각으로는 2026-10-05 00:53이에요. UTC를 2026-10-05로 읽으면 하루가 밀려요. HTTP 200이었고, cached는 false, x-cache는 MISS, 이 본문의 credits_used는 30이에요. period는 쿼리에 없었어요. 응답 period_days는 7이에요.

경로는 Prism의 GET /v1/prism/trend-board예요. 호스트는 SocialCrawl API예요. 공식 Query Videos의 region_code는 크리에이터가 계정을 등록한 나라이고, 정렬 값에 트렌딩은 없어요. 이 보드는 그 리서치 쿼리를 대신 친 것이 아니에요.

curl -sS \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  "https://www.socialcrawl.dev/v1/prism/trend-board?country_code=KR&limit=3"

이 런은 Cache-Control: no-cache도 보냈어요. 위 curl은 키와 쿼리만 있어요. cached는 false였어요. 같은 호출을 15분 안에 다시 하지 않아서, no-cache가 15분 캐시를 깨는지는 이 런으로 확인하지 않았어요.

아래 JSON은 엔벨로프와 카운트, 보드 소스 세 개만 자른 거예요. credits_used는 data 밖이에요. method 영어 단락, 사운드, 해시태그, 검색어 원문은 빼었어요. 잔액 필드는 공개하지 않아요.

{
  "success": true,
  "platform": "prism",
  "endpoint": "/v1/prism/trend-board",
  "data": {
    "country": "KR",
    "period_days": 7,
    "generated_at": "2026-10-04T15:53:06.085Z",
    "policy_version": "n22-2026-09-23",
    "breakout_posts": [],
    "unavailable": [],
    "counts": {
      "feed_rows": 8,
      "feed_rows_in_country": 1,
      "too_young": 0,
      "creators_checked": 1,
      "creators_skipped": 1,
      "creators_skipped_by_reason": {
        "too_few_author_posts": 1
      },
      "below_cut": 0,
      "sounds_checked": 3
    },
    "sources": [
      { "key": "local_feed", "ok": true, "rows": 8 },
      { "key": "hashtag_board", "ok": true, "rows": 3 },
      { "key": "google_trending", "ok": true, "rows": 3 }
    ]
  },
  "credits_used": 30,
  "cached": false
}

generated_at은 2026-10-04T15:53:06.085Z예요. 응답이 끝난 시각은 2026-10-04T15:53:30Z예요. limit=3은 이 글의 예제 상한이에요. 사운드, 해시태그, 검색어가 3개인 것은 limit=3과 같아요. 게시물 0은 상한 때문에 잘린 결과가 아니에요.

소스 나머지 카운트도 같은 본문이에요. creator_pages는 ok, rows 10, calls 1, failed 0. sound_videos는 ok, rows 31, calls 3, failed 0. sound_details는 ok, rows 3, calls 3, failed 0. 피드, 해시태그 보드, Google이 모두 ok였다는 뜻이지, 게시물이 반드시 나온다는 뜻은 아니에요.

나라 안 작성자 1명이 빠져 게시물이 비었어요

method의 급상승 규칙은 이렇게요. 그 나라에 등록된 피드 영상 중에서, 조회수가 그 작성자 다른 게시물 중앙값의 3배 이상이면 급상승이에요. 고정 게시물과 48시간이 안 된 게시물은 빼요. 비교는 최소 8개예요. 이 런은 그 배율을 다시 계산하지 않았어요. 응답에 적힌 규칙과 카운트만 읽어요.

카운트는 그 규칙이 왜 빈 배열이 됐는지 보여 줘요. feed_rows는 8인데 feed_rows_in_country는 1이에요. 피드에서 본 행 여덟 개 중 나라에 잡힌 작성자는 한 명이에요. creators_checked 1, creators_skipped 1, 이유는 too_few_author_posts 1건이에요. too_young은 0, below_cut도 0이에요. 중앙값 3배에서 탈락한 게시물이 이 응답에 남아 있다는 뜻은 아니에요. 비교 자체가 성립하지 않아 그 작성자가 빠진 거예요. 작성자 핸들은 응답 카운트에 없어서 만들지 않았어요.

그래서 이 응답의 틱톡 인기 게시물 칸은 빈 배열이에요. 한국 전체에 급상승 게시물이 없다는 뜻은 아니에요. limit=3이라 세 건이 잘려 0이 된 것도 아니에요. 이 호출, 이 상한, 이 시각의 결과예요.

나라로 계정을 고르는 일은 이 보드가 아니에요. 틱톡 유저 검색, KR 3건 전부 한국 · 15크레딧이 그 경로예요. 그 글의 15크레딧과 ZZ는 이 보드의 영수증이 아니에요.

사운드 세 개 중 새 곡은 하나예요

사운드 정책 버전은 d10-2026-09-23이에요. 셋 다 uses_on_feed는 1이에요. 피드에서 보인 횟수예요. 그 사운드의 영상 수와는 달라요. recent_days는 3이에요. 최근 영상이 3개라는 뜻이 아니에요. feed_views는 이 피드에서 본 조회수고, total_videos는 그 사운드에 붙은 영상 수예요. 둘을 한 지표로 더하지 않아요. artist가 null인 칸은 비워 두었어요. 미상이라고 채우지 않아요.

앞의 둘은 status가 established예요. Xlowly NY8은 사운드 게시가 2024-11-22T06:01:39.000Z, total_videos 160328, recent_videos 0, recent_share 0이에요. 첫 페이지에서 날짜가 있는 영상은 14개, 날짜가 없는 영상은 0개예요. VINGANÇA DEMONÍACA PHONK (Slowed)는 artist가 dwizdaboi, 게시가 2023-08-04T02:05:55.000Z, total_videos 1388368, 최근 영상 0, 첫 페이지 날짜 있는 영상 12개예요. 조회수는 피드 기준으로 1870649예요. 영상 수가 백만을 넘어도 최근 3일 창의 recent_videos는 0이에요.

새 곡으로 표시된 것은 세 번째뿐이에요. original sound - teamtrump는 status가 new, artist는 null, total_videos는 8, recent_videos는 1, recent_share는 0.2예요. 사운드 게시는 2026-09-24T19:07:32.000Z이고, 첫 페이지 범위는 2026-09-24부터 2026-10-04예요. 날짜가 있는 첫 페이지 영상은 5개, 없는 것은 0개예요. recent_videos 1과 recent_share 0.2가 같이 왔어요. 그 비율을 다시 나누어 검증하지는 않았어요. feed_views 1847160은 영상 8개와 같은 단위가 아니에요.

sounds_checked가 3이고 배열도 3개예요. limit=3과 같아서, 한국 피드의 사운드가 세 개뿐이라는 뜻은 아니에요.

해시태그 1위는 급상승이 아니에요

해시태그 성장은 method가 일별 곡선의 마지막 3분의 1과 처음 3분의 1을 비교한다고만 말해요. growth_ratio 0.15, 9.77, 9.6은 그 필드 그대로예요. 퍼센트나 배수로 읽지 않아요.

1위 틱톡인생작콘테스트는 게시물 7933, 창 조회 44502082로 셋 중 가장 커요. rising은 false예요. 순위와 급상승 플래그는 같지 않아요. 2위 liveincentiveprogram과 3위 paidpartnership은 게시물과 조회가 더 작은데 rising이 true이고 growth_ratio가 9.77, 9.6이에요. 창 조회가 크다고 급상승으로 표시되지는 않아요.

세 태그 모두 from_zero는 false, curve_points는 7이에요. first_seen_in_window.date는 2026-09-26이고 censored는 true예요. 여기서 censored는 정치적 검열이 아니에요. 창이 잘렸다는 표시예요. 그 날짜를 정확한 첫 관측일로 단정하지 않아요. 점이 7개인 것은 이 응답의 period_days 7과 나란히 있어요. 곡선을 다시 그려 0.15가 맞는지 계산하지는 않았어요.

Google 검색어 세 개는 검색량 필드 그대로예요

검색어 세 개의 increase_percent는 모두 1000이에요. ended_at은 null, active는 true예요. 1000을 몇 배로 읽지 않아요. search_volume도 필드 값 그대로예요. 같은 1000이 검색량 차이를 없애지는 않아요.

method는 검색어의 첫 시각이 Google이 준 시작 시각이라고 해요. 표의 started_at이 그 칸이에요. Trending Now 도움말의 Active는 아직 평소보다 많이 검색되는 상태이고, Ended는 평소 수준으로 돌아온 상태예요. 이 세 행은 active가 true이고 ended_at이 null이에요. 도움말의 시작 필터에는 과거 4시간, 과거 24시간, 과거 48시간, 과거 7일이 있어요. 이 보드는 Google 검색어를 7일로 읽었어요. Google이 7일만 공개한다는 뜻은 아니에요.

이 검색어는 관심도가 시간축으로 쌓인 시계열이 아니에요. 그 시계열과 0크레딧 404는 구글 트렌드 API, 관심도 0이면 404·0크레딧에 있어요. 속도 실측은 두 배 빨라진 구글 트렌드 API — 한국 로케이션 실측에 있고, 그 글의 시간을 이 보드 숫자로 가져오지는 않았어요.

핀터레스트 트렌드는 어느 나라 검색어인가요?

핀터레스트 트렌드는 트렌드 보드와 다른 호출이에요. GET /v1/pinterest/trends?country=KR&type=growing&limit=3은 HTTP 200, cached false, credits_used 10이었어요. 응답이 끝난 시각은 2026-10-04T15:53:06Z예요. market은 KR, type은 growing, 항목은 3, dropped는 0이에요.

curl -sS \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  "https://www.socialcrawl.dev/v1/pinterest/trends?country=KR&type=growing&limit=3"

1위만 자른 JSON이에요. 세 행은 표에 있어요. URL은 뺐어요.

{
  "success": true,
  "platform": "pinterest",
  "endpoint": "/v1/pinterest/trends",
  "data": {
    "items": [
      {
        "rank": 1,
        "term": "베스퍼",
        "country": "KR",
        "market": "KR",
        "type": "growing",
        "search_index": 59,
        "weekly_change": 0.4,
        "monthly_change": 100.01,
        "yearly_change": 100.01,
        "seasonality": 0.32291752,
        "as_of": "2026-09-30"
      }
    ],
    "total": 3,
    "dropped": 0
  },
  "credits_used": 10,
  "cached": false,
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "page_size": 3
  }
}

as_of는 호출 시각이 아니라 2026-09-30이에요. 세 항목이 같아요. 1위 베스퍼의 search_index 59는 2위 추석짤의 100보다 작아요. 이 응답에서 순위는 search_index 내림차순이 아니에요. 가을 손톱의 yearly_change는 -0.7이에요. type이 growing이어도 연간 변화 필드가 음수일 수 있어요. 음수 부호는 그대로예요.

weekly_change, monthly_change, yearly_change, seasonality, search_index의 단위는 이 본문이 말하지 않아요. 0.4를 퍼센트로 읽지 않아요. Pinterest Trends 도움말은 자기 사이트의 검색량을 전체 검색 대비 비율로 설명하고 그래프 최고를 100으로 둬요. 그 문장이 이 JSON 필드의 단위라는 뜻은 아니에요.

pagination.page_size는 3, has_more는 false, next_cursor는 null이에요. limit=3으로 받은 이 페이지의 플래그예요. 한국 growing 검색어가 시장 전체로 3개뿐이라는 뜻은 아니에요. total 3도 limit=3과 같아요. 이 런은 KR 외의 나라를 부르지 않았어요.

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

애플뮤직 차트도 별도 호출이에요. 쿼리는 country=kr 소문자, type=songs, limit=3이에요. HTTP 200, cached false, credits_used 1이에요. 차트 제목은 인기곡, country_code는 KR, updated_at은 2026-10-04T15:53:16.000Z예요. 응답 종료도 그 UTC 시각이에요.

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

1위만 자른 JSON이에요. 이 곡 객체에는 재생 수 칸이 비어 있어요.

{
  "success": true,
  "platform": "apple_music",
  "endpoint": "/v1/apple_music/charts",
  "data": {
    "total": 3,
    "dropped": 0,
    "items": [
      {
        "post": {
          "id": "6813395915",
          "content": {
            "text": "CRASH",
            "duration_seconds": null
          },
          "author": {
            "display_name": "ALLDAY PROJECT",
            "verified": null
          },
          "engagement": {
            "views": null,
            "likes": null,
            "comments": null,
            "shares": null,
            "saves": null
          },
          "published_at": "2026-09-28T00:00:00.000Z",
          "ext": {
            "trend": {
              "rank": 1,
              "country_code": "KR",
              "chart": "songs",
              "chart_title": "인기곡",
              "updated_at": "2026-10-04T15:53:16.000Z"
            }
          }
        },
        "computed": {
          "engagement_rate": null,
          "content_category": null
        }
      }
    ]
  },
  "credits_used": 1,
  "cached": false,
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "page_size": 3
  }
}

세 곡 모두 engagement의 views, likes, comments, shares, saves가 null이에요. duration_seconds, verified, content_advisory, computed.engagement_rate도 null이에요. null은 0회 재생이 아니에요. 계산 필드가 채워진 호출은 아니에요. content_category는 1위와 2위가 null이고, 3위 LOVE ATTACK만 other예요.

data.total은 3, dropped는 0, page_size는 3, has_more는 false예요. limit=3이라 한국 인기곡 차트 전체가 3곡이라는 뜻은 아니에요. has_more: false도 이 페이지의 플래그예요. 순위는 ext.trend.rank에 있고, 좋아요 수로 매긴 순위가 아니에요. 이 런은 country=kr만 봤어요. uk를 gb로 읽는지는 아래 질문에 따로 적어요.

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

없어요. 프로덕트 헌트는 나라 보드가 아니고, 트렌드 보드나 Pinterest나 Apple Music과도 다른 호출이에요. 쿼리에는 country가 없어요. 이 한국어 런에서는 다시 부르지 않았어요. 같은 날 영어 런이 topic=developer-tools로 받아 둔 본문을 재사용했어요. 그 캡처는 HTTP 200, cached false, credits_used 1, 항목 50, dropped 0이에요. 헤더 시각은 Sun, 04 Oct 2026 15:49:31 GMT예요. 그 1크레딧은 이 한국어 런에서 다시 낸 돈이 아니에요.

이 한국어 런에서 청구된 것은 트렌드 보드 30, Pinterest 10, Apple Music 1이에요. 합은 41이에요. 재사용한 1은 그 41 밖이에요.

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

피드 1번만 자른 JSON이에요. 50행 전체를 붙이지 않았어요. credits_used 1은 그 캡처의 값이에요.

{
  "success": true,
  "platform": "producthunt",
  "endpoint": "/v1/producthunt/launches",
  "data": {
    "total": 50,
    "dropped": 0,
    "items": [
      {
        "post": {
          "id": "1259946",
          "url": "https://www.producthunt.com/products/corespeed",
          "content": {
            "text": "One MCP for everything your agents need: apps, memory, tools"
          },
          "author": {
            "username": null,
            "display_name": "Justin Jincaid"
          },
          "engagement": {
            "views": null,
            "likes": null,
            "comments": null,
            "shares": null,
            "saves": null
          },
          "flags": {
            "deleted": false
          },
          "published_at": "2026-09-24T08:34:40.000Z",
          "ext": {
            "title": "CoreSpeed",
            "updated_at": "2026-10-04T08:47:54-07:00"
          }
        },
        "computed": {
          "language": "en",
          "content_category": "other",
          "engagement_rate": null
        }
      }
    ]
  },
  "credits_used": 1,
  "cached": false,
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "page_size": 50
  }
}

page_size 50, has_more false, next_cursor null이에요. _warnings 키는 이 응답에 없어요. 없는 토픽은 이 런에서 부르지 않아서, 빈 목록이 되는 분기는 여기 없어요. 공식 Product Hunt API 2.0은 GraphQL이고 토큰이 필요해요. 이 목록은 그 문서를 다시 열어 받은 결과가 아니에요.

참여 필드는 50건 모두 비어 있어요. views, likes, comments, shares, saves의 null이 각 50이고, 값이 있는 건 0이에요. 본문에 votes라는 키가 없어요. null은 0표가 아니에요. 배열 순서는 이 피드의 순서예요. 투표 순위도 아니고, 시간 순도 아니에요. 항목에 순위 필드, 자체 웹사이트 필드, 토픽 필드는 없어요.

author.username은 50건 모두 null이에요. 이름은 display_name에만 있어요. flags.deleted는 50건 모두 false예요. published_at이 가장 이른 것은 OpenShip 2026-08-11T10:58:55.000Z, 가장 늦은 것은 Aperture 2026-10-03T19:44:58.000Z예요. 오늘 하루 런치 목록이 아니에요.

computed.language는 en 43, fr 3, de 1, null 3이에요. null 세 건은 Sente, CodeAF, Pastily예요. 전부 영어라는 뜻은 아니에요. content_category는 other 46, tech 4예요. tech 네 건은 Singularity, CodeAF, OpenCompanion, OpenShip예요.

1번 CoreSpeed의 태그라인은 One MCP for everything your agents need: apps, memory, tools예요. URL은 https://www.producthunt.com/products/corespeed이고, ext.updated_at은 2026-10-04T08:47:54-07:00이에요. 7번 Aperture가 2026-10-03이라 1번보다 늦어요. 앞에 있다고 최신인 것은 아니에요.

어떻게 시작하나요?

가장 작은 첫 호출은 위의 트렌드 보드 KR이에요. 키는 가입한 뒤 SocialCrawl에서 만들어요. 가입 시 무료 크레딧이 얼마인지는 이 캡처에 없어요. 익스플로러에서 코드 한 줄 쓰기 전에 응답을 먼저 볼 수 있어요. 주소는 익스플로러예요.

이 한국어 런의 트렌드 보드 호출은 30크레딧이었어요. 가격 히스토리는 호출 사이에 없어요. 다음 호출도 30이라고 약속하지 않아요. 여기 적은 금액은 이 본문이 청구한 값이에요. Pinterest growing은 그때 10, Apple Music 인기곡은 그때 1이었어요. 런치 목록이 필요하면 그것도 따로 불러요. 다섯 소스가 요청 하나에 들어오지는 않아요.

curl -sS \
  -H "x-api-key: $SOCIALCRAWL_API_KEY" \
  "https://www.socialcrawl.dev/v1/prism/trend-board?country_code=KR&limit=3"

네 경로의 쿼리는 이 글의 curl에 있어요. 엔드포인트마다 크레딧이 어떻게 적히는지는 엔드포인트 가격을 봐요. 영상 키워드 검색은 틱톡 영상 검색 API, 요리 30행에 국가 코드 · 1크레딧이에요. 그 글의 1크레딧은 이 보드 가격이 아니에요.

같은 표를 다시 받으려면 아래 네 줄을 그 시각에 다시 호출하면 돼요. 트렌드 보드는 호출 사이에 기록을 남기지 않아서, 이 글의 표가 아니라 그 시점의 보드가 돌아와요.

• GET /v1/prism/trend-board?country_code=KR&limit=3
• GET /v1/pinterest/trends?country=KR&type=growing&limit=3
• GET /v1/apple_music/charts?country=kr&type=songs&limit=3
• GET /v1/producthunt/launches?topic=developer-tools

마지막 줄은 나라 필터가 없어요. 앞의 세 줄만 한국 코드가 들어가요. 첫 줄만 TikTok과 Google 검색어가 한 응답이에요.

자주 묻는 질문

없는 국가 코드도 과금되나요?

이 한국어 런은 country_code=ZZ를 부르지 않았어요. 없는 코드의 400은 이 한국어 런의 결과가 아니에요. 같은 날 영어 런의 GET /v1/prism/trend-board?country_code=ZZ가 HTTP 400, credits_used 0, INVALID_REQUEST였어요. KR은 이 한국어 런에서 200이었고 30크레딧이 빠졌어요. 계정 검색 글의 ZZ와는 경로가 달라요.

period를 30으로 하면 어떤 섹션만 바뀌나요?

이 런은 period를 보내지 않았고 응답 period_days는 7이에요. 30일 본문은 만들지 않았어요. 받는 값은 7이 기본이고 30뿐이에요. 바뀌는 것은 TikTok 해시태그 창이에요. 이 보드의 Google 검색어는 method상 7일로 읽혀요. days 파라미터는 없어요.

해시태그 보드가 비어도 나머지가 오나요?

이 KR 호출은 hashtag_board가 ok, rows 3, unavailable가 빈 배열이에요. 빈 섹션을 시연한 것이 아니에요. 계약으로는 소스 하나가 실패하면 그 섹션만 비고 이유를 말해요. 피드, 해시태그 보드, Google이 모두 실패할 때만 환불해요. 이번엔 그 세 소스가 모두 ok였어요.

15분 안에 같은 호출을 다시 하면 새 트렌드인가요?

아니에요. method는 호출 사이에 히스토리가 없고, 15분 안의 같은 호출은 캐시라고 적어요. 이 런은 그 반복을 하지 않았어요. 이번 cached는 false예요. 캐시된 반복을 시계열로 쌓지 않아요.

uk를 넣으면 애플뮤직 차트는 어느 나라로 읽나요?

이 런은 country=kr만 보냈고 응답 country_code는 KR이에요. uk 호출은 없어요. 계약으로는 uk를 gb로 읽어요. gb 차트 JSON은 이 글에 없어요.