Virlo 소개 (2026년): 기능, API 비용 및 Python 시작 코드

몇 달 전, 누군가 인기 있는 Virlo 튜토리얼 아래에 댓글을 남기며 작성자에게 Virlo의 어느 부분을 사용했는지 물었습니다. 'comet/orbit 등?' 아무도 대답하지 않았습니다. 오늘 Comet이나 Orbit을 찾아보면 모두 Virlo 문서에서 사용 중단(deprecated)으로 표시되어 있는데, 이는 이 제품이 1월 이후 얼마나 빠르게 변화했는지를 보여줍니다.

저는 소규모 크리에이터 에이전시 몇 곳의 데이터 파이프라인 작업을 합니다. 이제 계획 회의마다 거의 항상 Virlo가 언급되는데, 보통 'Virlo에서 이걸 가져올 수 없을까요?'라는 식으로요. 그래서 저는 현재 문서를 처음부터 끝까지 읽고 스크래치 프로젝트에 연결하는 데 시간을 보냈습니다. 제가 갖고 싶었던 글은 다음과 같습니다: 2026년 10월의 Virlo가 무엇인지, API가 어떻게 비용을 청구하는지, 자체 지출을 추적하는 Python 시작 코드, 그리고 다른 대안으로 무엇을 찾았는지에 대한 내용입니다.

마지막 부분에 대한 간략한 고백이 있습니다: Virlo는 디스커버리 도구이며, 특정 이름의 경쟁자가 매주 TikTok에 올리는 콘텐츠를 모니터링하는 더 좁은 작업의 경우 저는 Reachara를 사용합니다. 이 분할에 대한 자세한 내용은 끝부분에서 다루겠습니다.

그렇다면 Virlo는 정확히 무엇인가요?

Virlo의 홈페이지에서는 이를 TikTok, Reels 및 Shorts를 위한 소셜 리스닝(social listening)이라고 부릅니다. 실제로는 단편 비디오의 대규모 데이터베이스(홈페이지에 따르면 1470만 개 이상의 아웃라이어 비디오)와 그들이 성공한 이유를 설명하는 AI 레이어가 결합된 것입니다.

핵심 아이디어는 **아웃라이어(outlier)**입니다. 즉, 해당 크리에이터가 평소의 조회수를 뛰어넘은 비디오를 말합니다. 예시로, 보통 2.5K 조회수를 얻던 크리에이터가 갑자기 2.8M을 얻는 경우입니다. 이 비디오는 정상적인 한 주를 보낸 대형 계정보다 높은 순위에 오릅니다. 이는 올바른 직관인데, 왜냐하면 단순한 조회수만으로는 누가 이미 유명한지 대부분 알려주기 때문입니다.

그 위에 다음과 같은 것들이 놓여 있습니다:

• 콘텐츠 리서치 에이전트(Content research agents). 특정 틈새시장(niche)을 문장으로 설명하면, 해당 에이전트가 검색어들을 작성하고 TikTok, Instagram, YouTube 전반에 걸쳐 일회성 또는 예약된 일정에 맞춰 일치하는 영상을 가져옵니다.
• 분석 자료(Breakdowns). 각 영상별 후크(Hook), 형식(format), 각도(angle)를 제공하며,

이들은 Virlo의 이전 에이전트 엔드포인트였습니다. 일회성 리서치는 Orbit을, 반복적인 작업은 Comet을 사용했습니다. 두 기능 모두 이제 문서에서 "Legacy (deprecated)" 아래에 위치하며, POST /v1/agents를 사용하도록 안내합니다. 하나의 엔드포인트가 is_recurring 플래그와 함께 이 두 경우를 모두 처리합니다. 일회성 에이전트는 생성 시 비용이 청구되며, 반복적인 에이전트는 생성은 무료이고 실행할 때마다 $0.50이 청구됩니다. 속도 제한(rate-limit) 문서에는 이전 에이전트 엔드포인트가 분당 2회까지 낮았다고 추가되어 있으며, 대체 엔드포인트는 정상적인 제한을 가집니다. 만약 오래된 튜토리얼이나 사용자 코드에서 여전히 /v1/orbit 또는 /v1/comet을 호출한다면 마이그레이션해야 합니다.

자체 지출을 모니터링하는 Python 시작 스크립트

이것은 제가 모든 Virlo 실험을 시작할 때 사용하는 스크립트입니다. 잔액(무료)을 확인하고, 오늘 날짜의 미국 트렌드(25센트)를 가져오고, 하나의 해시태그(5센트)를 확인하며, 문서에서 설명하는 방식으로 429 오류를 처리하고, 실행 비용을 알 수 있도록 X-Cost를 합산합니다.

import os
import time

...

환경 변수에 VIRLO_API_KEY를 설정하고 실행하세요. 응답의 모든 내용은 data 아래에 있으며, 필드 이름은 snake_case이고, Virlo가 트렌드를 측정하기 전까지는 momentum이 null일 수 있으므로 or {}를 사용합니다.

주의해야 할 세부 사항들

이것들은 모두 문서에 있지만 여러 페이지에 흩어져 있습니다:

주의해야 할 세부 사항들

이것들은 모두 문서에 있지만 여러 페이지에 흩어져 있습니다:

• 일별 트렌드 목록은 뉴욕 시간으로 오전 7시에 초기화됩니다. 그 전에 호출하면 title에 오늘이라고 적혀 있어도 어제 목록을 받게 됩니다. title 대신 local_date를 확인하세요. 트렌드는 오후 1시와 오후 7시에 다시 추가됩니다.
• 해시태그 범위는 최대 90일까지이며, 통계는 2024년 6월 1일부터 시작합니다. 91일 범위를 요청하면 invalid_date_range와 함께 400 에러를 반환합니다.
• 경로(path)에 절대 #을 넣지 마세요. 원시 #은 URL을 깨뜨리므로, 태그 자체를 사용하거나 %23을 사용하세요.
• 해시태그에는 platform 매개변수가 없습니다. 특정 플랫폼의 경우 /v1/tiktok/hashtags, /v1/youtube/hashtags 또는 /v1/instagram/hashtags를 호출해야 합니다. platform을 전달하면 400 에러가 발생합니다.
• 최상위 해시태그 목록은 특정 틈새 시장(niche)에 국한되지 않으므로, fyp와 shorts가 선두입니다. 틈새 해시태그의 경우 문서는 콘텐츠 리서치 에이전트(content research agent)를 안내합니다.
• count는 TikTok의 수가 아니라 Virlo의 수입니다. 이는 지정된 날짜에 해당 태그를 사용한 Virlo 데이터 내 비디오 수를 의미합니다. 조회수는 게시 후 약 일주일 후에 고정됩니다.
• 이상치 확인(outlier check)은 호출할 때마다 요금이 부과됩니다. 크리에이터, 사운드 및 해시태그 검색은 캐시에서 6시간 동안 무료로 제공되지만, 비디오 이상치 확인은 그렇지 않으며 실패하더라도 청구됩니다.
• 속도 제한(Rate limits)은 키별, 엔드포인트별로 적용되며, UTC 시계에 맞춰 초기화됩니다. 해시태그 통계와 트렌드는 분당 50회 요청이 가능하며, 크리에이터 검색 및 이상치 확인은 각각 5회만 가능합니다.

AI 어시스턴트 워크플로우를 위해 MCP 서버도 있습니다. 개발자 사이트에서는 이 서버가 Claude, Cursor, VS Code와 같은 클라이언트에게 46개의 도구를 노출한다고 합니다. 저는 아직 아무것도 여기에 옮기지 않았지만, 에이전트 환경에서 활동하는 사람이라면 누구나 생각할 만한 다음 단계입니다.## 제가 Virlo 사용을 중단하는 경우

Virlo는

그 좁은 범위의 작업이 바로 Reachara가 구축된 목적입니다. 웹사이트, @핸들 또는 해시태그로 경쟁사를 지정하면 해당 계정의 영상들이 포함되는 최대 12개의 TikTok 해시태그를 추론하고, 예약된 일정(엔트리 플랜 기준 주간, 그 이상은 일일)에 따라 이를 수집하며, 게시물 수를 게재 계정 팔로워 수로 나눈 값을 기준으로 순위를 매깁니다. 오직 TikTok 전용이며, 무료 티어 없이 두 개의 모니터링 경쟁사부터 월 $99로 시작하고, 초기에 명시하듯이 잠재 고객 인구 통계나 광고 지출액은 다루지 않습니다. 광범위한 발견을 원한다면 Virlo가 적합합니다. TikTok에서 고정된 관심 목록의 경쟁사를 모니터링하려면 Reachara가 적합합니다.

FAQ

Virlo는 무료인가요?
앱은 7일간 $0 체험판을 제공하며, 이후 월 $49부터 시작합니다. API는 구독료가 없으며, 선불 잔액을 충전하고 대부분의 요청은 $0.50 이하로 비용이 발생합니다. 잔액 확인 및 유료 결과 재읽기는 무료입니다.

Virlo에 API가 있나요?
네, https://api.virlo.ai/v1에서 사용할 수 있으며, 트렌드, 크리에이터, 해시태그, 사운드, 후크 및 리서치 에이전트를 위한 25개 이상의 엔드포인트와 웹훅(webhooks), MCP 서버를 제공합니다. 문서는 dev.virlo.ai에 있습니다.

Virlo는 어떤 플랫폼을 다루나요?
TikTok, YouTube Shorts, Instagram Reels를 지원하며, 리서치 에이전트 내부에서 Meta Ad Library도 이용할 수 있습니다.

Virlo Orbit과 Comet을 대체한 것은 무엇인가요?
POST /v1/agents. Orbit의 기능을 구현하려면 is_recurring을 false로 설정하고, Comet의 기능을 구현하려면 true로 설정합니다.

최종 참고 사항

팀 단위로 Virlo를 평가하는 경우, 잔액 확인과 트렌드 호출 하나부터 시작해 보세요. 전체 빠른 시작(quickstart) 비용은 쿼터(quarter) 정도입니다. API 문서를 열어두세요. 가격표와 속도 제한(rate limits)이 다른 어떤 곳보다 더 정확하게 명시되어 있습니다. 그리고 만약 실제 요구 사항이