{"uid":"cap_GM6KBnpAO17ZUEBoKCQBA","slug":"substack-category-feed-afac3d68","name":"Substack Category Feed","description":"Get a Substack category's feed: the posts and notes Substack shows for the topic, top, newest or posts only.","url":"https://x402.apidirect.io/v1/substack/category/feed?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":{"pages":{"type":"integer","default":1,"maximum":250,"minimum":1,"description":"Number of pages to fetch and merge into one response (1-250, billed per page returned). Each page returns about 11 items. Fetching stops early when there are no more results."},"sort_by":{"enum":["top","most_recent","posts"],"type":"string","default":"top","description":"Sort order: top, most_recent or posts (posts only, no notes)"},"category":{"type":"string","maxLength":100,"description":"Category ID or slug, e.g. 4 or technology. 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_J8eI0xK-h1oIZy4_CLaPZ","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":"Fetches the posts and notes feed for a specific Substack category, sortable by top, most recent, or posts only.","exampleAgentPrompt":"Pull the top posts from Substack's technology category — fetch 3 pages sorted by top so I can see what's performing best there.","exampleUseCases":[{"title":"Research popular finance newsletter content","prompt":"Get me the top 5 pages of posts from Substack's finance category sorted by top — I want to see what finance writers are covering most successfully."},{"title":"Monitor newest posts in a niche topic","prompt":"Fetch the most recent posts from Substack's politics category, just 1 page, so I can see what's been published lately."},{"title":"Curate posts-only feed for a content digest","prompt":"Pull 2 pages from Substack's culture category sorted by posts only — no notes, just articles — so I can compile a weekly reading digest."}],"resultDescription":"Returns a merged list of feed items (posts and/or notes) from the specified Substack category, up to 11 items per page. Each item includes post or note details as surfaced on Substack's category explore page, such as title, author, publication, and engagement signals. Multiple pages are merged into a single response.","failureModes":["Invalid or unrecognized category slug/ID returns an error or empty feed","Pages parameter out of range (below 1 or above 250) triggers validation error","Network or upstream Substack availability issues may cause partial results or timeout","Early stop when category has fewer items than requested pages"],"whenToPreferThis":"Use this endpoint when you need structured access to Substack's category-level feed — browsing topic areas like technology, finance, or politics — rather than searching by keyword or fetching a specific publication. It's ideal for content discovery, competitive research, or monitoring what's popular or new within a Substack topic vertical. Prefer it over the trending endpoint when you want category-specific rather than platform-wide content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:52.840Z","isFirstParty":false,"canonicalSlug":"substack-category-feed-afac3d68"}