get_top_organic_posts
Rank verified Instagram, TikTok and YouTube posts by performance or outlier strength.
Use get_top_organic_posts for viral content, organic winners, views, engagement, saves, shares and account-relative breakout performance.
Inputs
| Field | Type | Notes |
|---|---|---|
storeIds | string[] | Zero to five tracked shops |
concept | string | Optional global content concept |
platform | enum | all, instagram, tiktok, youtube |
sort | enum | views, likes, comments, shares, saves, engagement, outlier |
limit | number | 1–12 |
dateWindowDays | number | Optional, 1–365 |
Example
{
"storeIds": [],
"concept": "electrolyte powders",
"platform": "tiktok",
"sort": "outlier",
"limit": 8,
"dateWindowDays": 30
}Choose the right ranking
Use views for absolute distribution and engagement for interaction density. Use outlier to find posts that strongly outperformed the account's own baseline — often the better signal when comparing large and small accounts fairly.
Not every platform exposes every metric consistently. Read coverage and avoid treating an unavailable metric as zero.
Credit behavior
The maximum reservation is limit × max(1, number of stores). The final charge reflects posts actually returned.