{"uid":"cap_2c32TT6rYOJz8AWRqO0o5","slug":"api-direct-search-substack-notes-2a2ebfcc","name":"API Direct – Search Substack Notes","description":"Search Substack Notes by keyword.","url":"https://x402.apidirect.io/v1/substack/notes?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":["query"],"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 up to 12 notes. Fetching stops early when there are no more results."},"query":{"type":"string","maxLength":500,"description":"Search keyword (max 500 characters)."},"sort_by":{"enum":["most_recent","top"],"type":"string","default":"most_recent","description":"Sort order"},"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 page 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_D8wFpykUec1SU19X21daw","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":"Search Substack Notes by keyword, with optional AI sentiment analysis using Plutchik's Wheel of Emotions","exampleAgentPrompt":"Search Substack Notes for 'AI regulation', give me the top 2 pages sorted by most recent, and include emotion analysis so I can see how writers are feeling about the topic.","exampleUseCases":[{"title":"Brand mention monitoring on Substack","prompt":"Search Substack Notes for mentions of 'OpenAI' over the last few pages sorted by most recent — I want to see what writers are saying about them right now."},{"title":"Trending topic sentiment research","prompt":"Find the top Substack Notes about 'climate change' — get me 3 pages sorted by top and turn on the sentiment analysis so I can see the dominant emotions people are expressing."},{"title":"Competitive intelligence on newsletter content","prompt":"Search Substack Notes for 'interest rates' and pull 5 pages sorted by most recent so I can see what financial newsletter writers are covering this week."}],"resultDescription":"Returns a merged list of up to 12 notes per page (up to 250 pages) from Substack Notes matching the keyword. Each note includes content, author, and publication details. If sentiment analysis is enabled, each note also includes Plutchik's Wheel emotion scores, dominant emotion, emotional intensity, and polarity (positive/negative).","failureModes":["No results found for obscure or misspelled keywords","Rate limiting or payment failure if insufficient USDC balance","Requesting more pages than available results (fetching stops early)","Query exceeds 500-character limit","Invalid sort_by value other than 'most_recent' or 'top'","Pages value outside 1–250 range causing validation error"],"whenToPreferThis":"Use this endpoint when you need to search the Substack Notes feed specifically — the short-form social content on Substack, distinct from full newsletter posts or author profiles. Choose this over Substack author search when you want content/notes rather than profile discovery. The optional AI emotion analysis (Plutchik's Wheel) makes it uniquely suited for sentiment research without needing a separate NLP call. Prefer it when you need paginated, high-volume keyword retrieval across Substack's notes ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:24.443Z","isFirstParty":false,"canonicalSlug":"api-direct-search-substack-notes-2a2ebfcc"}