Search Viral Outlier Posts

Search 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.

post/api/v1/search/content

Request

  • Base URL: https://viraloutliers.com
  • URL: https://viraloutliers.com/api/v1/search/content
  • Auth: HTTP bearer

Request body

querystring

Keyword search over captions/titles/handles.

platformsstring[]

"tiktok" | "instagram" | "youtube".

handlestring

Exact creator handle (without @). Pins results to one account; takes precedence over the free-text query.

watchlistIdstring

Scope the search to the creators in one of your watchlists (id from list_watchlists / create_watchlist). Combine with any other filter.

categoryIdstring

Niche filter: a category id from list_categories. Covers the whole subtree (a Level 2 niche includes its sub-niches). Ignored when handle or watchlistId is set.

contentTypesstring[]

Content types to include, case-insensitive. TikTok: Video, Photo (slideshow). Instagram: Video (reel), Image, Carousel. YouTube: Video, Short, Live.

minOutlierScorenumber

Only posts overperforming their account baseline by at least this factor.

maxOutlierScorenumber

Upper bound on outlier score, e.g. exclude extreme one-off spikes.

minViewsnumber

Minimum view count.

maxViewsnumber

Maximum view count.

minFollowersnumber

Floor on account size, e.g. exclude tiny/brand-new accounts.

maxFollowersnumber

Cap account size, find small accounts with huge posts.

minEngagementRatenumber

Minimum engagement rate, as a fraction of views: (likes+comments)/views. So 0.04 means 4%.

maxEngagementRatenumber

Maximum engagement rate, same fraction scale (0.04 = 4%).

timeFramestring

"one_week" | "one_month" | … | "all_time".

sortBystring

Sort key: outlier/views/likes/date/engagement, each _desc or _asc (default outlier_desc).

pagenumber

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.

pageSizenumber

Results per page, 1 to 100 (default 25). Billed per 25 posts returned: 25 costs 1 credit, 100 costs 4.

Response

Success

object required

Changes

No recorded changes to this operation across all 1 revision of this API.