Skip to main content
Use these only when the user asks for popular, top-selling, or most-purchased items. They are not a substitute for topic search or entity search. Free, no auth. Post cards include priceCents; the synthesizedSummary still comes from the paid publication-post route. MCP: list_top_selling_posts, list_top_selling_publications. limit is 1-100 on both routes (default 10).

Posts

GET /api/v1/posts/top-selling ranks posts by purchase count, then earnings. It only lists posts with ready synthesized summaries from enabled publications.
Present each item as {title} ({publicationSlug}, YYYY-MM-DD) — $X.XX when priceCents is known. Keep publicationSlug + slug for the paid fetch.

Publications

GET /api/v1/publications/top-selling ranks publications by creator earnings, then purchase count.
articlePurchaseCount is completed purchases; purchasedArticleCount is distinct posts purchased. Disabled publications are excluded. totals covers all enabled publications, including those beyond the requested limit. After the user chooses a publication, call GET /api/v1/publications/ then unlock selected posts as usual.