Substack

Search Substack Posts

Search Substack posts by keyword across every publication. Returns post title, subtitle, author, publication, publication date, engagement (likes, comments, restacks), paywall status, word count, cover image and tags, plus the publications related to the query. Supports a time window from the past day to the past year.

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

get/v1/substack/posts

Request

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

Query parameters

querystring required

Search keyword (max 500 characters)

pageinteger

Page number for pagination (1-101). Each page returns 16-20 posts.

posted_ago'24h' | '7d' | '30d' | '12m'

Only return posts from this period: 24h (past day), 7d (past week), 30d (past month), or 12m (past year). Omit for all time. Any other value returns 400.

languagestring

Two-letter language code, e.g. es, to rank posts in that language first

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

querystring nullable
pagenumber nullable
has_next_pageboolean nullable
countnumber nullable

Changes

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