Substack Notes Scraper — Notes & Posts

The only Substack Notes scraper on the Apify Store. Pull notes from any writer's profile or search across all Substack Notes by keyword — with engagement metrics, media, and linked posts in every result.

What you get

• Note content — full text, note ID, posted date, and direct note URL
• Author info — handle, display name, and avatar URL
• Engagement metrics — likes, replies, and restacks per note
• Media & links — media URLs for notes with images, parsed mentions, and linked Substack posts

Sample output

{
  "note_id": "c-1234567890",
  "author_handle": "@platformer",
  "author_name": "Platformer",
  "author_avatar": "https://substackcdn.com/image/fetch/example.jpg",
  "text": "The future of media is independent. Substack Notes is where writers are building real communities.",
  "like_count": 342,
  "reply_count": 28,
  "restack_count": 56,
  "posted_date": "2026-08-01T14:30:00.000Z",
  "note_url": "https://substack.com/@platformer/note/c-1234567890",
  "has_media": true,
  "media_urls": ["https://substackcdn.com/image/fetch/note-example.jpg"],
  "mentions": ["@caseynewton"],
  "linked_post": {
    "title": "The end of the social media era",
    "url": "https://platformer.com/the-end-of-the-social-media-era"
  }
}

Use cases

• Newsletter author monitoring — Track what writers are saying about your brand or topic on Substack Notes
• Content research — Find top-performing notes in your niche to inform your content strategy
• Engagement tracking — Measure likes, replies, and restacks to gauge writer influence
• Writer influence analysis — Discover high-engagement Substack writers for partnerships
• Note trend detection — Identify trending notes and discussions on the fastest-growing writer platform

Input

Field	Type	Required	Default	Description
mode	string	Yes	profile	profile for author notes, search for keyword search
handle	string	profile mode	—	Substack handle without @ (e.g., platformer)
searchQuery	string	search mode	—	Keyword to search across all Substack Notes
maxNotes	integer	No	50	Maximum notes to return (1-500)

Pricing

from $1 per 1,000 results You only pay for the data you actually receive — failed or empty requests are not charged.

Plan	Price per 1,000 results
Free	$1.00
Starter (Bronze)	$0.80
Scale (Silver)	$0.60
Business (Gold)	$0.40

The first run is free under Apify's free tier, so you can test with a small batch before scaling up.

Technical details

• Profile mode: Uses Substack's public API — fast and reliable, no authentication required
• Search mode: Uses Playwright browser automation to scroll the Substack Notes feed and filter by keyword
• Pagination: Up to 500 notes per run via the maxNotes parameter
• No authentication needed — both modes work without any login credentials
• Export formats: JSON, CSV, XML, Excel, or HTML via Apify
• Integrations: REST API, webhooks, Zapier, Make, Airbyte, and LangChain

FAQ

What are Substack Notes? Notes are Substack's short-form social posts, similar to tweets. They include text, media, mentions, and engagement metrics. Notes can be posted by any Substack writer and are visible on the platform's social feed.

Do I need a Substack account? No, the scraper works with public notes. No authentication is required for either mode.

What is the difference between profile and search mode? Profile mode pulls all notes from a specific Substack author's profile using the public API. Search mode scrolls through the Substack Notes feed and filters results by your keyword, giving you notes from across the entire platform.

How many results can I get per run? Up to 500 results per run using the maxNotes parameter. For broader searches, run multiple times with different keywords or handles.

Is scraping Substack legal?

Yes. This scraper only accesses publicly available Notes data through Substack's public API and browser automation of public pages. It does not bypass authentication or access private data. Always check Substack's Terms of Service for restrictions on how you use the data.

Related actors

Actor	Platform	Use case
Bluesky Search Scraper	Bluesky	Decentralized social posts & profiles
Threads Profile Scraper	Threads	Meta's text platform
BitChute Video Scraper	BitChute	Alternative video platform data
Farcaster Cast Scraper	Farcaster	Web3 social data
Spoutible Profile Scraper	Spoutible	Twitter alternative monitoring
Gab Search Scraper	Gab	OSINT & alternative platform monitoring

Support

Need a custom feature or found a bug? Open an issue on the Actor's page and we'll respond within 24 hours. We can also build custom scrapers for your specific use case — just reach out.