급상승 검색어에서 콘텐츠까지 두 번의 호출
시드 키워드의 연관 검색어와 급상승 검색어를 조회하고 선택한 검색어를 그대로 소셜 검색에 넣어 상위 게시물을 확인합니다. 이 API에서 가장 많이 반복되는 트렌드 작업이며 가치는 완전한 수집이 아니라 빠른 포착에서 나옵니다.
엔드포인트 순서
trends/rising -> tiktok/search -> post활용 사례
급상승 검색어에서 콘텐츠까지 잇는 트렌드 감지 API
지금 상승 중인 검색어와 해시태그를 확인하고 그 흐름을 만든 게시물을 같은 키로 이어서 조회합니다. 호출 주기는 직접 정하고 이력은 자체 저장소에 쌓습니다.
/v1/google_trends
급상승 검색어와 해당 게시물
- GET /v1/google_trends/rising
- GET /v1/google_trends/explore
- GET /v1/tiktok/trending
- GET /v1/instagram/search/hashtag
트렌드 감지 API는 지금 상승 중인 검색어와 해시태그, 인기 피드를 반환하고 그 흐름을 만든 콘텐츠까지 조회하게 합니다. SocialCrawl은 급상승 검색어와 지역별 인기 피드를 46개 플랫폼의 키워드 및 해시태그 검색과 연결하므로 급상승 신호에서 실제 게시물까지 같은 키와 같은 스키마로 이어집니다.
실제로 만들어지는 것
모두 현재 운영 중인 패턴입니다. 각 카드 아래의 엔드포인트 순서가 실제 호출 순서입니다.
지역별 인기 피드
전 세계 평균을 보고 국내에 적용되기를 기대하는 대신 실제로 판매하는 시장의 인기 피드를 요청합니다. 매일 실행하고 전날 결과와 비교해 새로 진입한 항목을 확인합니다.
엔드포인트 순서
tiktok/trending (by region)해시태그에서 릴스로
해시태그를 검색한 뒤 같은 검색어로 릴스를 검색합니다. 주제 자체가 움직이는지, 특정 포맷이 흐름을 끌고 있는지 구분할 수 있습니다.
엔드포인트 순서
instagram/search/hashtag -> search/reels고정 키워드 패널
고정된 키워드 목록의 기간별 관심도를 자체 주기로 조회하고 결과를 직접 저장합니다. 며칠간의 기울기를 확인해야 일시적 급등과 실제 추세를 구분할 수 있습니다.
엔드포인트 순서
google_trends/explore (keyword panel)쇼츠 인기 피드
같은 흐름을 확인하는 두 번째 신호로 인기 쇼츠를 조회합니다. 독립된 두 피드가 같은 방향을 가리키면 단일 피드보다 신뢰도가 높습니다.
엔드포인트 순서
youtube/shorts/trending네이버 쇼핑 수요
네이버 쇼핑 카테고리 안에서 키워드별 클릭 추이를 0에서 100 사이 지수로 반환합니다. 상품 목록이나 가격이 아니라 검색어 사이의 상대 수요를 보여 주므로 한국 카테고리 규모를 가늠할 때 사용합니다.
엔드포인트 순서
naver/shopping-insight (Korean demand)트렌드 감지 API 동작 방식
네 번의 호출로 시드 키워드에서 급상승 검색어의 실제 콘텐츠까지 이어집니다. 두 개는 트렌드 조회이고 두 개는 콘텐츠 수집입니다.
조회는 크레딧으로 과금됩니다. 트렌드 엔드포인트는 호출당 정액이고 콘텐츠 검색은 페이지 단위로 과금하며 업스트림 실패는 자동 환불됩니다.
GET /v1/google_trends/rising급상승 검색어 확인
시드 키워드와 지역을 전달하면 연관 검색어와 급상승 검색어를 반환합니다. 이후 단계 전체의 입력이 됩니다.
호출당 5크레딧GET /v1/tiktok/search해당 콘텐츠 수집
급상승 검색어를 키워드 검색에 넣고 지금 실제로 상위에 노출되는 영상을 페이지 단위로 조회합니다.
페이지당 1크레딧GET /v1/instagram/search/reels다른 포맷 확인
같은 검색어로 릴스를 검색해 흐름이 단일 피드 안에 있는지 포맷을 넘어 확산되는지 확인합니다.
페이지당 1크레딧GET /v1/google_trends/explore기간별 추적
해당 검색어를 키워드 패널에 추가하고 기간별 관심도를 조회해 다음 실행에서 기울기를 확인합니다.
호출당 5크레딧
트렌드를 감지할 수 있는 플랫폼
모두 같은 키로 동작하는 레인입니다. 링크를 열면 해당 플랫폼의 전체 엔드포인트를 확인합니다.
기존 구성과 비교
대부분 트렌드 대시보드를 읽은 뒤 그 상승을 만든 콘텐츠를 찾기 위해 별도 작업을 시작합니다. 달라지는 지점은 다음과 같습니다.
| Capability | SocialCrawl | 일반적인 구성 |
|---|---|---|
| 신호에서 근거로 | 급상승 검색어를 그대로 키워드와 해시태그 검색에 넣어 해당 게시물을 확인합니다. | 검색어를 내보낸 뒤 원인을 찾기 위한 수집 작업을 따로 시작합니다. |
| 지역 | 인기 피드와 관심도 데이터를 시장 단위로 요청합니다. | 실제로 판매하는 시장을 가리는 전 세계 평균만 제공합니다. |
| 호출 주기 | 필요한 만큼 자주 조회하고 전체 이력을 자체 저장소에 보관합니다. | 갱신 주기가 고정되고 이력은 공급업체 대시보드 안에 남습니다. |
| 한국 수요 | 네이버 검색어 트렌드와 쇼핑 클릭 추이를 글로벌 소스와 같은 키로 조회합니다. | 한국은 별도 현지 공급업체로 분리되거나 아예 다루지 않습니다. |
| 커버리지 | 같은 API 키로 46개 플랫폼과 375개 엔드포인트에서 트렌드 조회와 콘텐츠 수집을 처리합니다. | 트렌드 제품과 소셜 스크래퍼를 각각 계약합니다. |
| 과금 방식 | 소멸되지 않는 크레딧 팩에서 호출 단위로 차감하므로 단기 조사도 일회성 비용입니다. | 좌석 수가 정해진 연간 라이선스입니다. |
트렌드 감지 API 자주 묻는 질문
트렌드 감지 API란 무엇입니까?
트렌드 감지 API는 상승 중인 검색어와 해시태그, 인기 피드 항목을 차트가 아니라 구조화된 데이터로 반환합니다. 같은 키로 소셜 검색도 조회하므로 급상승 검색어에서 그 흐름을 만든 게시물까지 하나의 작업 안에서 이어집니다.
트렌드를 얼마나 일찍 확인할 수 있습니까?
빠른 포착은 특별한 피드가 아니라 호출 주기에서 나옵니다. 급상승 검색어와 지역별 인기 피드가 공개된 신호 중 가장 이른 축에 속하며, 얼마나 일찍 잡는지는 조회 주기와 실행 결과를 얼마나 촘촘하게 비교하는지에 달려 있습니다.
국가별 트렌드 데이터를 받을 수 있습니까?
가능합니다. 급상승 검색어와 기간별 관심도는 지역을 파라미터로 받고 틱톡 인기 피드는 리전을 받습니다. 전 세계 기준으로는 평평한 검색어가 특정 국가에서는 가파르게 오르는 경우가 있으므로 시장 단위 요청이 중요합니다.
급상승 검색어에서 실제 게시물로 어떻게 넘어갑니까?
해당 검색어를 필요한 플랫폼의 키워드 검색에 넣고 상위에 노출된 게시물을 개별적으로 확인합니다. 트렌드 조회와 콘텐츠 수집이 같은 API 키를 쓰고 같은 스키마로 반환되므로 연동을 새로 붙이지 않고 변수만 바꾸면 됩니다.
한국어와 비영어권 수요도 다룹니까?
다룹니다. 네이버는 한국 검색어 트렌드와 카테고리별 쇼핑 클릭 추이를 0에서 100 사이 상대 수요 지수로 반환합니다. 스레드의 날짜 구간 검색은 동남아시아 제품과 커머스 검색어에 실제로 쓰이는 레인이고 뉴스 레인은 언어와 지역을 지정합니다.
급등이 발생하면 알림을 보냅니까?
이 API의 트렌드 작업은 푸시가 아니라 폴링 방식입니다. cron이나 워커, 자동화 도구에서 자체 주기로 호출하고 결과를 저장한 뒤 직접 비교합니다. 전체 이력이 자체 저장소에 남으므로 해당 카테고리에서 급등을 어떻게 정의할지 직접 정할 수 있습니다.
비용은 얼마입니까?
트렌드 조회는 호출당 5크레딧이고 이어지는 콘텐츠 검색은 페이지당 1크레딧입니다. 크레딧은 구독이 아니라 소멸되지 않는 팩에서 차감되므로 가끔 실행하는 조사도 그때 발생하는 비용으로 끝납니다. 가입 시 무료 크레딧 100개를 제공하고 카드 등록이 필요하지 않습니다.
AI에게 SocialCrawl을 물어보세요
요청
curl -G "https://socialcrawl.dev/v1/google_trends/rising" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "keyword=air fryer" \
--data-urlencode "location=US"curl -G "https://socialcrawl.dev/v1/tiktok/trending" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "region=GB"두 호출 모두 실제 데이터로 동작합니다. 키와 키워드만 바꾸면 그대로 실행됩니다.