# What’s Trending complete agent and product reference What’s Trending is a customer-interest radar for marketers, founders and lean content teams. Every new workspace can run one complete first scan free without a payment card. It monitors selected market terms and competitor profiles across public Reddit, Facebook, Instagram and X sources, preserves original post URLs and available engagement metrics, ranks recurring topics, and produces evidence-backed content directions. ## Canonical resources - Product site: https://whatstrending.cc/ - Application: https://app.whatstrending.cc/ - Human agent documentation: https://whatstrending.cc/for-agents - Agent skill: https://whatstrending.cc/skills.md - Markdown API guide: https://whatstrending.cc/api.md - REST API base: https://api.whatstrending.cc - OpenAPI 3.1 contract: https://api.whatstrending.cc/openapi.json - Agent manifest: https://api.whatstrending.cc/.well-known/agent.json - MCP discovery: https://api.whatstrending.cc/.well-known/mcp.json - MCP endpoint: https://api.whatstrending.cc/mcp - Blog feed: https://whatstrending.cc/feed.xml - Sitemap: https://whatstrending.cc/sitemap.xml The OpenAPI document is authoritative for REST paths, parameters, request bodies, and response shapes. ## Product setup 1. Create an account with email and password or Google Sign-In. 2. Provide a public website URL. 3. Review the automatically suggested WordBank terms and competitor URLs. 4. Add, edit, or remove terms and competitors. 5. Start a scan. The product stores source-linked evidence and builds a reusable history. ## Core data model - Workspace: one product, website URL, WordBank, competitor URLs, resolved platform handles, scan frequency, and lookback window. - Post evidence: platform, author, text, original URL, comments URL where available, publication time, matched terms, and source-specific public metrics. - Trend: watched topic, score, status, mention count, unique authors, platforms, aggregate engagement, summary, content idea, and supporting post IDs. - Report: a 48-hour pulse or seven-day summary generated from stored evidence. ## REST authentication Create a key in application Settings. Send it as: Authorization: Bearer wt_live_YOUR_KEY Keys are scoped to one workspace, displayed once, stored as hashes, and revocable. Never place a key in a query string or public page. ## REST capabilities - GET /v1/workspace: read the authenticated workspace configuration. - GET /v1/trends?days=7|30|90|180|365: read ranked topics for a supported window. - GET /v1/evidence: list source posts. Optional parameters include days, platform, q, and limit. - POST /v1/scans: run a fresh scan. A workspace cannot be scanned through the API more than once every 15 minutes. ## MCP-compatible tools The stateless Streamable HTTP endpoint is https://api.whatstrending.cc/mcp. - get_trends: returns ranked trends for a supported window. - list_evidence: returns public source evidence filtered by timeframe, platform, or text. - run_scan: performs a live scan and mutates scan history. Reuse recent evidence instead of repeatedly calling it. Use JSON-RPC initialize, notifications/initialized, tools/list, and tools/call. Supply the same Bearer key for authenticated tool calls. ## Metric interpretation Metric availability varies by platform and source. Fields can include likes, comments or replies, shares or reposts, quotes, saves, impressions, views, platform score, and upvote ratio. A missing metric is unknown, not zero. Compare posts using metrics exposed by the same source and method. ## Platform boundaries - Reddit uses public search feeds with a public archive fallback. Archive metrics can include score and comment count. - Facebook reads configured public Page feeds where accessible. Page visibility and readable metrics vary. - Instagram uses Meta’s authorized professional-account and Business Discovery surfaces. It cannot promise arbitrary private or ineligible account data. - X uses configured official access when present and public profile/embed fallbacks otherwise. Public fallback coverage can be profile-oriented rather than exhaustive term search. What’s Trending never claims access to private posts, private comments, private impressions, or metrics a source does not expose. ## Trend scoring Topics are ranked from stored matching posts using activity, unique authors, recency, platform breadth, and available public engagement. Source posts remain the evidence layer; a score is a prioritization aid, not proof of total market demand. ## Recommended agent behavior 1. Read the workspace before choosing terms or timeframes. 2. Read trends, then inspect the supporting evidence before making a content recommendation. 3. Preserve original source URLs when presenting claims. 4. Distinguish unavailable metrics from zero engagement. 5. Trigger a scan only when current evidence is stale. 6. Treat generated content ideas as briefs that require human review. ## Public research resources - Use-case guides: https://whatstrending.cc/use-cases - Social listening for content marketing: https://whatstrending.cc/use-cases/social-listening-for-content-marketing - Customer research from public conversations: https://whatstrending.cc/use-cases/customer-research - Reddit monitoring for customer insights: https://whatstrending.cc/use-cases/reddit-monitoring - Trending topics for social media: https://whatstrending.cc/use-cases/trending-topics-for-social-media - Social media competitor analysis: https://whatstrending.cc/use-cases/social-media-competitor-analysis - Free tools: https://whatstrending.cc/tools - Social content idea generator: https://whatstrending.cc/tools/social-content-idea-generator - Engagement-rate calculator: https://whatstrending.cc/tools/engagement-rate-calculator - Social-listening query builder: https://whatstrending.cc/tools/social-listening-query-builder - Planning templates: https://whatstrending.cc/templates - Blog: https://whatstrending.cc/blog - Social-listening glossary: https://whatstrending.cc/glossary - Privacy: https://whatstrending.cc/privacy - Terms: https://whatstrending.cc/terms Last verified: 2026-08-22