Substack

Get Substack publication feed

Get a Substack publication's feed with its newest items.

GET/v1/substack/publications/{publication}/feed
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
publicationstringrequiredpath

A publication: its numeric id (`89120`), its Substack subdomain (`astralcodexten`), its host (`www.astralcodexten.com`) or its URL. A numeric id is refused with a 400 on the routes that need a subdomain, host or URL.

min 1 chars · max 400 chars

Response fields
29

Endpoint-specific response payload.

datalookupStatus
string

Whether the publication was found.

one of: found, not_found, restricted

datarestrictedReason
stringnullable

Why the publication is restricted, when it is.

one of: invite_only, flagged, paid, null

The publication's feed when it is served; otherwise null.

datafeedtitle
stringnullable

The feed's title.

datafeeddescription
stringnullable

The feed's description.

datafeedurl
stringnullable

The publication's URL.

datafeedimageUrl
stringnullable

The feed's image URL.

datafeedgenerator
stringnullable

The software that produced the feed.

datafeedlastBuildDate
stringnullable

When the feed was last built.

datafeedcopyright
stringnullable

The feed's copyright line.

datafeedlanguage
stringnullable

The feed's language code.

The feed's newest items.

datafeeditems[]title
stringnullable

The item's title.

datafeeditems[]url
stringnullable

The item's URL.

datafeeditems[]guid
stringnullable

The item's stable id.

datafeeditems[]creator
stringnullable

The item's creator.

datafeeditems[]publishedAt
stringnullable

ISO 8601 timestamp, or null when Substack does not publish one.

datafeeditems[]descriptionHtml
stringnullable

The item's description as HTML.

datafeeditems[]description
stringnullable

The same description with entities decoded and HTML tags removed.

datafeeditems[]contentHtml
stringnullable

The item's full content as HTML.

The item's image or audio enclosure.

datafeeditems[]enclosureurl
string

The enclosure's URL.

datafeeditems[]enclosuretype
stringnullable

The enclosure's media type.

datafeeditems[]enclosurelength
integernullable

The enclosure's size in bytes.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/substack/publications/astralcodexten/feed" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Substack publication feed.