Substack

List a Substack category's bestseller leaderboard

Returns one page of a category's bestseller leaderboard, pairing each ranked publication with its author. This is a different surface from /substack/category: it exposes the trending ranking (the site's "Rising" tab), validates its ranking values rather than silently defaulting, accepts the extra cross-category id bestseller, and returns the author alongside the publication. Use a category_id from /substack/categories whose in_leaderboard is true. Upstream serves 25 rows per page and accepts pages 0-25.

get/substack/leaderboard

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/substack/leaderboard
  • Auth: API key in header x-api-key

Query parameters

category_idstring required

Category id from /substack/categories with in_leaderboard true. Numeric, or the string ids podcast or bestseller.

type'trending' | 'paid' | 'all'

Ranking to read

pageinteger

Zero-based page, 0-25

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Changes

No recorded changes to this operation across all 4 revisions of this API.