Substack

Substack User Posts

Get an author's posts across all their publications, newest first. Returns post title, publication, publication date, engagement, paywall status, word count and tags. Supports fetching multiple pages in a single API call.

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

get/v1/substack/user/posts

Request

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

Query parameters

usernamestring

Substack handle, e.g. lenny, with or without a leading @ (max 100 characters). Provide one of username, user_id or url.

user_idstring

Numeric Substack user ID, as returned in user_id. Provide one of username, user_id or url.

urlstring

Profile URL, e.g. https://substack.com/@lenny (max 500 characters). Provide one of username, user_id or url.

pagesinteger

Number of pages to fetch and merge into one response (1-60, billed per page returned). Each page returns up to 50 posts. Fetching stops early when there are no more results.

get_sentimentboolean

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.

Response

Successful response

usernamestring nullable
user_idstring nullable
pagesnumber nullable
countnumber nullable

Changes

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