This page is a quick reference for the current QlearNews backend API. Most public JSON endpoints are available directly from https://api.mypenmail.info.
JSON is public and CORS-enabled for https://mypenmail.info. Use /docs or /openapi.json for the OpenAPI reference when available.
Lists articles with category, source, timeframe, sorting, and pagination support.
/articles?category=news&page=1&pageSize=30Searches articles using full-text search and fallback matching. Also supports category and pagination.
/search?q=redstone&category=crypto&page=1&pageSize=10Searches articles, expands matching cluster memberships, and attaches cluster-level signals.
/api/story-clusters?q=redstone&category=crypto&page=1&pageSize=9Returns latest trending topics by category, including momentum, mentions, source counts, context, and sample headlines.
/api/trending?category=tech&limit=10General summary route alias. Useful for summary data exposed outside the category summary endpoint.
/api/summariesReturns twice-daily AI editorial summaries by category, including summary text, bullets, and cluster metadata.
/api/category-summariesReturns the generated daily digest content used by the frontend digest component.
/api/daily-digestReturns market trend/report data used by the reports and market-watch UI.
/api/market-trendsPrometheus/business metrics endpoint. May be used internally for monitoring.
/metricsSwagger UI and machine-readable OpenAPI schema.
/docsAuthentication routes for account/session features. Methods and payloads depend on the auth route implementation.
/authComment routes for article/community features. Some operations may require authentication.
/commentsCurrent scheduled backend flow for article signals, story clusters, and summaries.
Refreshes article-level sentiment, urgency, optimism, and signal data.
00,30 * * * *Runs storage/buildClusterArticles.js and writes story membership rows to dbo.cluster_articles.
05,35 * * * *Runs storage/buildClusterSignals.js and writes cluster-level signal aggregates to dbo.cluster_signals.
10,40 * * * *Refreshes trending topics.
*/15 * * * *Builds morning category summaries with Gemini.
15 7 * * *Builds evening category summaries with Gemini.
15 19 * * *Builds daily digest content.
0 0,12 * * *Default limit 30. Use page and pageSize to paginate the JSON. Search uses /search; empty browsing uses /articles.