API Direct

Substack User Activity

GET /v1/substack/user/activity

Get an author's public activity feed: their Notes and the posts they publish or restack, newest first, or only their notes, posts, replies, restacks or likes. Each item is tagged note, post or comment and says what the author did with it. Notes carry text, engagement and any quoted post or note.

Cost

$0.003 per page

Free tier

50 requests/month

Parameters

username

Substack handle, e.g. lenny, with or without a leading @ (max 100 characters). Provide one of username, user_id or url.

user_id

Numeric Substack user ID, as returned in user_id. Provide one of username, user_id or url.

url

Profile URL, e.g. https://substack.com/@lenny (max 500 characters). Provide one of username, user_id or url.

type

Only this kind of activity: note, post, reply, restack or like

pages

Number of pages to fetch, 1-250 (default: 1). Each page returns 12 items; you are billed per page returned.

Example Request

curl "https://apidirect.io/v1/substack/user/activity?username=hamish&pages=1"   -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/substack/user/activity",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"username": "hamish", "pages": 1}
)
print(response.json())

Example Response

{
  "count": 24,
  "items": [
    {
      "activity": "note",
      "attachments": [
        {
          "attachments": [
            {
              "post_id": "218085342",
              "publication": "On Substack",
              "title": "Model Behavior: George Saunders",
              "type": "post",
              "url": "https://on.substack.com/p/model-behavior-george-saunders"
            },
            {
              "duration": 44.6,
              "height": 1280,
              "type": "video",
              "url": "https://substack.com/api/v1/video/upload/c7e75333-51e0-4895-9c1c-597fbbdb5d11/src",
              "width": 720
            }
          ],
          "author": "arielleswedback",
          "author_name": "Arielle Swedback",
          "body": "@George Saunders spoke about Substack and our AI conversation yesterday on Late Night with Seth Meyers. Grateful to him for helping us see our way through",
          "note_id": "355302724",
          "type": "note",
          "url": "https://substack.com/@arielleswedback/note/c-355302724"
        }
      ],
      "author": "hamish",
      "author_bestseller_tier": 0,
      "author_id": "3567",
      "author_name": "Hamish McKenzie",
      "author_pic_url": "",
      "author_url": "https://substack.com/@hamish",
      "body": "Still feels like a massive honor just for @George Saunders to be publishing on Substack, let alone be speaking of it on the big shows. ",
      "date": "2026-10-08 04:48:40",
      "domain": "substack.com",
      "lang": "en",
      "likes": 53,
      "note_id": "355659691",
      "publication": "Disjointed",
      "reactions": {
        "❤": 53
      },
      "replies": 5,
      "restacks": 3,
      "source": "Substack",
      "type": "note",
      "url": "https://substack.com/@hamish/note/c-355659691"
    }
  ],
  "pages": 2,
  "user_id": "3567",
  "username": "hamish"
}

Your Usage

Free tier this month

Recent Activity