Viral finder: viral post discovery
Viral finder is a ready-made SocialToAI tool that returns posts on a subject that did clearly better than their authors usually do, on one platform. A run costs from 24 credits and is priced before it starts; a run that fetches nothing is not charged. Run it here, in your AI over MCP, or over the API.
Last updated:
Formats and openings are read from titles and captions, not from what is said in a video. This is a sample of what search returns for the subject, not everything posted.
| Row | Likes | What the analysis said |
|---|---|---|
| 用话梅酱来惊艳你们 | 1,970 | Showcase |
| 咖啡行业专业词 大白话翻译 | 1,262 | How-to |
| 哼(￣^￣) | 994 | Showcase |
| 聪明杯的3种萃取方式，从入门到比赛用法都不同 | 355 | How-to |
| 想喝明白咖啡就去逛咖啡展 | 329 | Other |
| 拼搏正当时，青春不设限 | 153 | Unsure · not counted |
| 咖啡小课堂：青柠茉莉流沙美式！ | 113 | How-to |
| 日本人喝咖啡，为什么总是一个人？ | 155 | Story |
- Every number is counted by code from the delivered rows; a percentage is of the rows that could be judged, and its sample is named beside it.
- A quote is a piece of the original text, checked character for character. Commenters are never named.
- The full result is kept for 24 hours. Export it to keep it.
How credits are counted.
One fixed price, shown before you run.
- Nothing fetched, nothing charged
- Credits never expire
| Depth | What it reads | From | On the 100 free credits |
|---|---|---|---|
| Smallruns while you wait | Searches 3 pages. | 24≈ $0.08 | Yes |
| Mediumruns while you wait | Searches 3 pages and checks the usual level of the top 10 authors. | 54≈ $0.18 | On 4 of 5 platforms |
| Largeruns while you wait | Searches 5 pages and checks the usual level of the top 30 authors. | 130≈ $0.43 | After your first purchase |
What it takes.
What comes back.
| Name | Type | Required | What it is |
|---|---|---|---|
query | string | Yes | The subject, as keywords. |
platform | string | Yes | One platform. |
window | string | No | How far back to look.7d30d |
scale | string | No | small searches 3 pages; medium adds the usual level of the top 10 authors; large searches 5 pages and adds the top 30 authors.smallmediumlarge |
max_cost_credits | integer | No | Refused, free, with the quote, if the run would cost more. |
confirm | boolean | No | true: run it whatever it costs. false: answer the plan and its price, and run nothing. Left out: a costly run, and one that runs in the background, answers its price first. |
| Part | What it holds |
|---|---|
| Viral posts | Posts that did clearly better than their authors usually do, and by how much. |
| Main number | Viral posts |
Same tool, where you already work.
Ask your AI, or call it from code.
Connect SocialToAI once over MCP. After that, ask in plain words and your AI runs the tool for you.
https://mcp.socialtoai.com/mcpresearchwith tool viral_finderOne POST request returns the same result. Send max_cost_credits, and a run that would cost more is refused for free, with the quote.
curl https://api.socialtoai.com/v1/tools/viral_finder \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "air fryer recipes", "platform": "tiktok", "window": "7d", "scale": "small" }'import osimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/tools/viral_finder", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "query": "air fryer recipes", "platform": "tiktok", "window": "7d", "scale": "small", },)print(response.json())Before you run it.
Short answers.
Read the docsWhat does a run cost?
From 24 credits at the Small depth, for one subject on one platform. The price depends on the depth and the platform, and the table on this page has every number. You see the total before anything runs, and a run never costs more than that.
What am I charged if a run finds nothing or stops partway?
If nothing could be fetched, the run is not charged. If content was fetched but the conditions you set filtered all of it out, only the first half of the fetching price is charged. If a run stops partway, you are charged only for the part that finished.
What happens when a platform fails?
The run goes on with what could be read, and the result says how much of the plan that was. The price has three parts: two for fetching and one for the AI analysis. When less than half of the planned reading came back, the second fetching part is not charged. The analysis part is charged only when at least nine in ten of the delivered rows were analysed. A call whose outcome is unknown is never retried on our own.
Which platforms does it cover?
6 platforms now: TikTok, X, YouTube, Xiaohongshu, Douyin, Bilibili. One run reads one platform.
Can I run it on the free credits?
Sign-up includes 100 credits, no card. They can run: Small; Medium on 4 of 5 platforms. Running a tool on a schedule is available after your first purchase.