Substack

Search Substack Notes

Search Substack Notes by keyword. Returns each note's text, author, date, engagement (likes, replies, restacks) and any quoted post or note, newest first or top first. Supports fetching multiple pages in a single API call.

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

get/v1/substack/notes

Request

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

Query parameters

querystring required

Search keyword (max 500 characters).

sort_by'most_recent' | 'top'

Sort order

pagesinteger

Number of pages to fetch and merge into one response (1-250, billed per page returned). Each page returns up to 12 notes. 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

countnumber nullable
pagesnumber nullable
querystring nullable
sort_bystring nullable

Changes

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