{"uid":"cap_tk3Ut9f22aIvfriiC7R3e","slug":"api-direct-substack-post-likes-6c8a3401","name":"API Direct – Substack Post Likes","description":"Get the people who liked a Substack post.","url":"https://x402.apidirect.io/v1/substack/post/likes?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."},"publication":{"type":"string","maxLength":500,"description":"Publication subdomain, host or URL, used together with slug."}}}},"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_vZ8bemKvNS5R1HzSQdt_-","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 list of users who liked a specific Substack post.","exampleAgentPrompt":"Can you get me the list of people who liked this Substack post: https://www.lennysnewsletter.com/p/all-of-the-lenny-and-friends-summit?","exampleUseCases":[{"title":"Audience engagement analysis for newsletter","prompt":"Pull the list of users who liked this Substack post — https://www.lennysnewsletter.com/p/product-market-fit — so I can see who's engaging most with the content."},{"title":"Influencer outreach from post likers","prompt":"Get me everyone who liked this Substack post at https://every.to/chain-of-thought/the-knowledge-economy so I can identify potential brand ambassadors to reach out to."},{"title":"Competitive benchmarking of post reactions","prompt":"Fetch the likes for the Substack post with slug 'future-of-ai' on publication 'stratechery.substack.com' so I can compare engagement against our own posts."}],"resultDescription":"Returns a list of Substack users who liked the specified post, including user profile information (e.g. names, handles, profile URLs) and potentially a total like count. The post can be identified via a full URL, a numeric post ID, or a combination of publication subdomain and slug.","failureModes":["Post not found (invalid URL, slug, or post ID returns an error or empty result)","Publication subdomain provided without slug or vice versa — incomplete identifier","Post URL exceeds 500 character limit","Private or paywalled posts may return no likes or an access error","Rate limiting if too many requests are made in quick succession","Network timeout if Substack's underlying data is slow to respond"],"whenToPreferThis":"Use this endpoint when you need to identify or analyze the specific users who liked a Substack post, for purposes such as audience research, influencer identification, or engagement benchmarking. It supports flexible post identification (URL, post ID, or publication+slug), making it convenient regardless of how you reference the post. Prefer this over scraping Substack directly or using generic web extraction tools when you want structured, ready-to-use liker data without parsing HTML.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:47.749Z","isFirstParty":false,"canonicalSlug":"api-direct-substack-post-likes-6c8a3401"}