Search the viral library
xcut_search_viralIdempotent
Use this when the user asks what is going viral, trending or performing right now on Instagram, TikTok, YouTube or Facebook for a topic or niche, what a creator posts that works, or what ads run in the Meta Ad Library. mode is keyword (a topic) or profile (an account). Returns posts with views, engagement, links and captions, plus next_cursor for more. 2 credits per page (cached pages free). Do not use for general web or news search, or for one profile's outliers versus its own normal (use xcut_find_outliers).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | keyword to search a topic (e.g. "meal prep"), or profile to see an account's top posts (query = @handle). Default keyword. | keyword |
| limit | No | Posts per page, 1-30. Default 15. | |
| query | Yes | A topic, or a handle when mode is profile. | |
| cursor | No | next_cursor from the previous page. | |
| platform | Yes | instagram, tiktok, youtube, facebook, or meta_ads for the Meta Ad Library. |