{"uid":"cap_gxhOMUR7i0C44kT9ehOmG","slug":"api-direct-get-substack-note-by-url-or-id-fcab9bec","name":"API Direct – Get Substack Note by URL or ID","description":"Get a Substack Note by URL or ID, with its replies.","url":"https://x402.apidirect.io/v1/substack/note?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":"Note URL, e.g. https://substack.com/@hamish/note/c-355659691 (max 500 characters). Provide either url or note_id."},"note_id":{"type":"string","description":"Numeric note ID, with or without the c- prefix. Provide either url or note_id."},"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_HGmiernm71Q-opGbzi9Ka","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 a single Substack note (short-form post) along with its replies, given a note URL or numeric note ID, with optional AI emotion analysis.","exampleAgentPrompt":"Can you pull up this Substack note for me — https://substack.com/@hamish/note/c-355659691 — and include all the replies? Also run the emotion analysis on it so I can see the sentiment.","exampleUseCases":[{"title":"Track reaction to a viral Substack note","prompt":"Fetch this Substack note at https://substack.com/@hamish/note/c-355659691 along with all its replies, and turn on the emotion analysis so I can see how people are reacting emotionally."},{"title":"Monitor replies to a specific note","prompt":"Get me the full thread for Substack note ID c-398271045, including all the replies — I want to see what people are saying in response."},{"title":"Sentiment check on a controversial note","prompt":"Look up Substack note c-412083776 and fetch it with sentiment analysis enabled — I want to know the dominant emotion and whether the tone is positive or negative."}],"resultDescription":"Returns the Substack note's content (text, author, timestamp, engagement counts) along with its reply thread. If get_sentiment is enabled, each item also includes Plutchik's Wheel emotion scores, the dominant emotion, intensity level, and polarity (positive/negative/neutral).","failureModes":["Note URL or ID not found — returns 404 or empty result","Invalid URL format — returns validation error","Note has been deleted or made private — returns error or empty content","Rate limit exceeded — returns 429","Payment not attached or insufficient — returns 402"],"whenToPreferThis":"Use this endpoint when you need the full content and reply thread of a specific Substack note identified by URL or ID. Prefer this over Substack search endpoints when you already have the note's URL or numeric ID and want structured data including replies. Choose the sentiment option when you need emotion analysis without a separate NLP call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:06:45.644Z","isFirstParty":false,"canonicalSlug":"api-direct-get-substack-note-by-url-or-id-fcab9bec"}