Substack

Substack Category Publications

Get a Substack category's leaderboard: the top publications ranked by Substack, each with its full details (subscriber badge, paid band, prices, author) and rank.

Price: $0.003 per request. Free tier: 50 requests/month.

get/v1/substack/category/publications

Request

  • Base URL: https://apidirect.io
  • URL: https://apidirect.io/v1/substack/category/publications
  • Auth: API key in header X-API-Key

Query parameters

categorystring required

Category ID or slug, e.g. 4 or technology (bestsellers and podcasts for the site-wide boards). See Category IDs (https://apidirect.io/docs/substack-category-ids)

tier'all' | 'paid' | 'rising'

all, paid or rising (bestsellers: rising; podcasts: all or paid)

pageinteger

Page number (default: 1), 25 publications per page. Up to 21 pages; rising 10; bestsellers and podcasts 4

Response

Successful response

tierstring nullable
pagenumber nullable
has_next_pageboolean nullable
countnumber nullable

Changes

No recorded changes to this operation across all 1 revision of this API.