# Changelog of Substack Scraper (`deriverge/substack-scraper`) Actor

- **URL**: https://apify.com/deriverge/substack-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/deriverge/substack-scraper.md

##### 2026-10-11

*Features*

- Keyword search across all of Substack. `searchQueries` returns matching posts with the same fields as newsletter posts, plus `searchQuery` and `searchRank` at the end of the row. Choose Top results of any age or Recent posts, narrow them by date, and add one row per newsletter that published them with **Include newsletters of found posts**.

*Changes*

- The form starts with a keyword search and has **Include post text** turned on, so the first run shows the text of each post. Runs started from the API keep the old defaults.

*Fixes*

- `subscriberTier` is `null` for small newsletters where Substack shows only how long ago they launched. It used to hold text such as `Launched a year ago`.
- Requests to Substack are paced, and after HTTP 429 the actor waits as long as Substack asks and slows down. If Substack keeps refusing, the actor stops asking and says so in the status message and `SUMMARY` instead of ending quietly.
- `newsletterSubdomain` of posts is filled from the post's byline when the newsletter header was not read.

##### 2026-09-30

*Fixes*

- Archives are read past the first 23 posts. Substack returns a short first page, and runs used to stop there even when the maximum was higher.
- In new-only mode, posts, comments and header rows cut off by **Maximum rows** or the spending limit arrive in the next run. They used to be marked as seen and never came.

##### 2026-09-28

*Changes*

- `newsletters` can also be sent as `urls`, `url`, `startUrls`, `newsletter`, `publications`, `publication`, `domains`, `domain` or `sites`, or as one text with the newsletters separated by commas or line breaks.

##### 2026-09-27

*Changes*

- The watch field is now called `watchName`. Runs that still send the old name `watchKey` keep working.

##### 2026-09-24

*Changes*

- Lower prices for posts, post text, comments and newsletter rows on every plan.

##### 2026-09-23

*Features*

- First version: posts from the archive of any Substack newsletter with their metrics, the post text on request, comments as rows, one header row per newsletter, filters by date, audience and keyword, and a new-only mode.