Skip to main content
GET
Get an article summary or podcast transcript (wallet).

Headers

Authorization
string

MPP (Payment HTTP Authentication Scheme): after HTTP 402, retry with Authorization: Payment <credential>. Account credentials (Bearer API key / JWT / OAuth) are not accepted on this mount.

PAYMENT-SIGNATURE
string

x402 v2: after HTTP 402, retry with the encoded payment payload from the PAYMENT-REQUIRED challenge (same header name as in @x402/core HTTP transport).

X-Drip-Unlock
string

HMAC unlock token from a prior successful settle (unlockToken in the JSON body or this same response header). When valid for this post, returns the live summary with no charge (paymentInfo.protocol: unlock).

Path Parameters

sourceSlug
string
required

Source slug (normalized host), e.g. bytesbeyondborders.substack.com

postSlug
string
required

Post slug within the source.

Response

Post summary with podcast transcript when applicable.

id
string
required

Internal post id.

sourceId
string
required

Source id.

sourceSlug
string
required

Source slug.

guid
string
required

Feed-level globally unique identifier.

slug
string
required

Post slug.

title
string
required

Post title.

subtitle
string | null
required

Post subtitle.

description
string | null
required

Short description from the feed.

url
string | null
required

Original post URL.

author
string | null
required

Post author.

imageUrl
string | null
required

Post hero or thumbnail image URL.

publishedAt
string | null
required

ISO publication timestamp.

synthesizedSummary
string
required

AI-synthesized post summary (returned after payment).

transcript
string | null
required

Raw speech-to-text transcript HTML for podcast episodes (returned after payment); null for non-podcast posts or when the transcript isn't ready yet.

unlocked
boolean

True on a free re-read of an already-unlocked post.

unlockToken
string

Issued on first x402/MPP grant. Echo as X-Drip-Unlock for free re-reads.

content
string

Raw Markdown body — book chapters only.