{"uid":"cap_rNNdZSEeCbwU2XZ2zW87O","slug":"api-direct-substack-post-comments-nested-thread-63ae32d0","name":"API Direct - Substack Post Comments (Nested Thread)","description":"Get the full comment thread of a Substack post, nested.","url":"https://x402.apidirect.io/v1/substack/post/comments?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":[],"properties":{"url":{"type":"string","maxLength":500,"description":"Post URL, e.g. https://www.lennysnewsletter.com/p/all-of-the-lenny-and-friends-summit (max 500 characters). Provide url, post_id, or publication and slug."},"slug":{"type":"string","maxLength":200,"description":"Post URL slug, e.g. all-of-the-lenny-and-friends-summit, used together with publication."},"post_id":{"type":"string","description":"Numeric post ID, as returned in post_id. Provide url, post_id, or publication and slug."},"sort_by":{"enum":["relevance","most_recent","oldest"],"type":"string","default":"relevance","description":"Sort order for the thread"},"publication":{"type":"string","maxLength":500,"description":"Publication subdomain, host or URL, used together with slug."},"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."}}}},"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_ApAg8sGTH4ROznKeFVguv","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":"Retrieves the full nested comment thread for a given Substack post, optionally with AI sentiment analysis.","exampleAgentPrompt":"Can you pull the full comment thread for this Substack post — https://www.lennysnewsletter.com/p/all-of-the-lenny-and-friends-summit — sorted by most recent, and include the emotion analysis for each comment?","exampleUseCases":[{"title":"Audience reaction research for newsletter","prompt":"Grab all the comments on this Substack article — https://www.workingtheorys.com/p/product-market-fit — sorted by relevance, and include the sentiment scores so I can see how readers emotionally responded."},{"title":"Competitive intelligence on rival publication","prompt":"Pull the nested comment thread for this post from Ben Thompson's Stratechery — publication is stratechery, slug is apple-vision — sorted by oldest first, so I can trace how the discussion evolved."},{"title":"Community moderation monitoring","prompt":"Fetch the full comment thread for post ID 145823901 on Substack, sorted by most recent, so I can quickly review any new replies that need moderation."}],"resultDescription":"Returns the full nested comment thread for the specified Substack post, including comment text, author info, reply structure, and timestamps. When sentiment analysis is enabled, each comment also includes Plutchik's Wheel emotion scores, a dominant emotion label, intensity rating, and polarity (positive/negative/neutral).","failureModes":["Post URL not found or invalid — returns error with no comment data","Post has no comments — returns empty thread","Ambiguous post identifier (missing both post_id and the publication+slug pair) — returns validation error","Rate limiting or payment failure — returns 402 or 429 status","Sentiment analysis flag enabled but upstream AI service unavailable — may return partial results or error"],"whenToPreferThis":"Choose this endpoint when you need the full nested comment thread of a Substack post — not just top-level comments — especially when reader discussion depth and reply chains matter. It is ideal for sentiment research, audience analysis, or community monitoring on Substack specifically. Prefer it over generic scraping when you want structured nested data and optional emotion analysis (Plutchik's Wheel) in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:03.144Z","isFirstParty":false,"canonicalSlug":"api-direct-substack-post-comments-nested-thread-63ae32d0"}