{"uid":"cap_1bTZwFGBhhjAqov1NoQ7y","slug":"substack-category-leaderboard-048b3568","name":"Substack Category Leaderboard","description":"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.","url":"https://x402.apidirect.io/v1/substack/category/publications?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["category"],"properties":{"page":{"type":"integer","default":1,"maximum":21,"minimum":1,"description":"Page number (default: 1), 25 publications per page. Up to 21 pages; rising 10; bestsellers and podcasts 4"},"tier":{"enum":["all","paid","rising"],"type":"string","description":"all, paid or rising (bestsellers: rising; podcasts: all or paid)"},"category":{"type":"string","description":"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)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_q3ynJ73h-2RH9Akz6dDb2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ranked list of top Substack publications in a given category, with full details including subscriber badge, pricing, paid tier, and author info.","exampleAgentPrompt":"Can you pull up the Substack leaderboard for the technology category — show me the top paid publications on page 1?","exampleUseCases":[{"title":"Discover top newsletters in a niche","prompt":"Show me the top Substack publications in the technology category, just the paid ones, starting from page 1."},{"title":"Track rising newsletters for market research","prompt":"I'm doing competitive research — can you get the rising Substack newsletters in the finance category and tell me who's gaining traction?"},{"title":"Find top podcasts on Substack site-wide","prompt":"What are the top Substack podcasts across the whole platform? Pull the site-wide podcast leaderboard for me."}],"resultDescription":"A paginated ranked list of Substack publications for the specified category, each entry including rank position, publication name, subdomain, subscriber badge level, paid subscription band, pricing tiers, and author details. Up to 25 publications per page.","failureModes":["Invalid or unrecognized category ID/slug returns an error or empty results","Page number out of range (above 21 for standard, above 4 for rising/bestsellers/podcasts) returns an error","Invalid tier enum value returns a validation error","Payment not processed results in 402 response","Rate limits exceeded return a 429 error"],"whenToPreferThis":"Use this endpoint when you need ranked leaderboard data for Substack publications within a specific category, including tier filtering (all, paid, rising) and pagination. Prefer this over the Substack search endpoint when you want Substack's own ranking signal rather than keyword-based search results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:50.950Z","isFirstParty":false,"canonicalSlug":"substack-category-leaderboard-048b3568"}