Posts
Returns a publication’s recent posts, or one post: title, full text and Markdown, author, reactions, comments, restacks, word count and whether it is paid.
Use it with a publication URL (or custom domain) for its archive, or a /p/ post URL for one post.
Metered: 10–120 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.
Request
- Base URL: https://api.insightsocial.app
- URL: https://api.insightsocial.app/v1/substack/posts
- Auth: API key in header x-api-key
Query parameters
A Substack publication URL or custom domain, or one post URL (…/p/slug).
Most recent posts to read, 1 to 100. Default 25. Billed per post returned.
Only posts published on or after this date (YYYY-MM-DD). Applied to the limit most recent posts, so raise limit to reach further back.
Only posts published on or before this date (YYYY-MM-DD). Applied to the limit most recent posts, so raise limit to reach further back.
true for free (non-paywalled) posts only.
Only one post type. Default all.
Only posts with at least this many comments.
Only posts with at least this many reactions.
Only posts with at least this many words.
Include the article body (text and Markdown). Default true; false is faster.
Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.
Response
Success.
Changes
No recorded changes to this operation across all 1 revision of this API.