Search Viral Outlier Posts
search_outliersSearch a continuously-crawled database of social media posts ranked by outlier score: how strongly a post overperforms the account's own baseline. Filter by platform, keyword, exact creator handle, content type, an outlier-score band (min/max), a view band (min/max), a follower band (min/max), an engagement-rate band (min/max) and time window; sort by outlier score, views, likes, engagement or recency. Returns post metadata, stats and thumbnails. Use this to find proven viral formats in any niche before creating content. Results may include deleted posts (deleted_at set) and posts from deactivated profiles (profile is_active=false), these are kept for their thumbnails and format ideas, with stats frozen at deletion; filter on deleted_at / is_active if you only want live content. Cost: 1 credit per 25 posts returned.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, 1-based. A search serves its first 1,000 posts; a page past that is refused at no charge, so narrow the filters instead. | |
| query | No | Keyword search over captions/titles | |
| handle | No | Exact creator handle filter | |
| sortBy | No | ||
| maxViews | No | ||
| minViews | No | ||
| pageSize | No | Results per page, 1 to 100 (default 25). Billed per 25 posts returned: 25 costs 1 credit, 100 costs 4. | |
| platforms | No | ||
| timeFrame | No | ||
| categoryId | No | Niche filter: a category id from list_categories (covers its subtree) | |
| watchlistId | No | Scope to the creators in one of your watchlists (id from list_watchlists) | |
| contentTypes | No | ||
| maxFollowers | No | ||
| minFollowers | No | ||
| maxOutlierScore | No | ||
| minOutlierScore | No | ||
| maxEngagementRate | No | ||
| minEngagementRate | No |