Substack

Substack Publication Posts

Get a publication's posts, newest first, top or most discussed, or search them by keyword. Returns post title, author, publication date, engagement, paywall status, word count and tags.

Price: $0.003 per request. Free tier: 50 requests/month.

get/v1/substack/publication/posts

Request

  • Base URL: https://apidirect.io
  • URL: https://apidirect.io/v1/substack/publication/posts
  • Auth: API key in header X-API-Key

Query parameters

publicationstring required

Publication subdomain (lenny), host (lenny.substack.com, www.lennysnewsletter.com) or any URL on it (max 500 characters)

querystring

Keyword to search the publication's posts for (max 500 characters). Results are by relevance; sort_by is ignored.

sort_by'most_recent' | 'top' | 'discussions'

Sort order for the archive

podcasts_onlyboolean

Set to true to return only podcast episodes (most_recent archive only).

pageinteger

Page number for pagination. Each page returns up to 20 posts.

get_sentimentboolean

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.

Response

Successful response

publication_urlstring nullable
sort_bystring nullable
podcasts_onlyboolean nullable
pagenumber nullable
has_next_pageboolean nullable
countnumber nullable
queryunknown

Changes

No recorded changes to this operation across all 1 revision of this API.