{"uid":"cap_eJrer_Ini2x-udEfKRxPX","slug":"api-direct-substack-publication-posts-1efad2b5","name":"API Direct – Substack Publication Posts","description":"Get a publication's posts, newest first, top or most discussed, or search them by keyword.","url":"https://x402.apidirect.io/v1/substack/publication/posts?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":["publication"],"properties":{"page":{"type":"integer","default":1,"minimum":1,"description":"Page number for pagination. Each page returns up to 20 posts."},"query":{"type":"string","maxLength":500,"description":"Keyword to search the publication's posts for (max 500 characters). Results are by relevance; sort_by is ignored."},"sort_by":{"enum":["most_recent","top","discussions"],"type":"string","default":"most_recent","description":"Sort order for the archive"},"publication":{"type":"string","maxLength":500,"description":"Publication subdomain (lenny), host (lenny.substack.com, www.lennysnewsletter.com) or any URL on it (max 500 characters)"},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis (Plutchik's Wheel) to each result. Adds +$0.001 per request to the cost. Returns emotion scores, dominant emotion, intensity, and polarity."},"podcasts_only":{"type":"boolean","default":false,"description":"Set to true to return only podcast episodes (most_recent archive only)."}}}},"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_3GSoGPUWmtty19FsEjG5d","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":"Retrieve a Substack publication's posts sorted by newest, top, or most discussed, or search them by keyword — with optional AI sentiment analysis.","exampleAgentPrompt":"Show me the top 20 most-discussed posts from Lenny's Newsletter on Substack — search through them for anything about 'product-market fit' and include AI sentiment analysis on the results.","exampleUseCases":[{"title":"Newsletter research by keyword","prompt":"Search Lenny's Substack (lenny.substack.com) for all posts mentioning 'growth loops' and show me the most relevant ones."},{"title":"Track a writer's latest output","prompt":"Pull the 20 newest posts from the 'Stratechery' Substack publication so I can see what Ben Thompson has been writing about recently."},{"title":"Podcast episode archive browsing","prompt":"Get me only the podcast episodes from 'The Diff' newsletter on Substack, sorted by most recent, starting from page 1."}],"resultDescription":"A paginated list of up to 20 posts from the specified Substack publication, including post titles, dates, and metadata. When searching by keyword, results are ranked by relevance. When sort_by is used, results are ordered by most_recent, top, or discussions. If get_sentiment is true, each post also includes Plutchik's Wheel emotion scores, the dominant emotion, intensity level, and polarity (positive/negative).","failureModes":["Invalid or unresolvable publication subdomain returns an error or empty result","Keyword query exceeding 500 characters is rejected","Requesting sort_by with a keyword query is ignored (relevance overrides sort)","Page number beyond available archive returns empty results","Publication with no posts or a private/paywalled archive may return empty or partial results","Network timeouts or Substack rate limiting may cause request failures"],"whenToPreferThis":"Use this endpoint when you need to browse, search, or monitor posts from a specific known Substack publication — particularly when you want keyword search, sorting by engagement or recency, or optional AI emotion scoring on results. Prefer this over the trending Substack endpoint when you have a target publication in mind rather than wanting cross-platform trending content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:51.940Z","isFirstParty":false,"canonicalSlug":"api-direct-substack-publication-posts-1efad2b5"}