Substack

List a Substack user's followers, following, or subscribers

Returns one of a user's public connection lists. Each entry is a full profile in the same shape as /substack/user, subscriber signals included. user_id is the numeric id returned by /substack/user. The upstream returns a bounded preview of each list rather than the complete membership.

get/substack/user/connections

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/substack/user/connections
  • Auth: API key in header x-api-key

Query parameters

user_idinteger required

Numeric user id from /substack/user

list'followers' | 'following' | 'subscribers'

Which list to read

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "list": "followers",
    "name": "Followers",
    "user_id": 49731969,
    "users": [
      {
        "bestseller_tier": 10000,
        "handle": "pragmaticengineer",
        "id": 2067309,
        "name": "Gergely Orosz",
        "publications": [
          {
            "id": 458709,
            "name": "The Pragmatic Engineer",
            "role": "admin"
          }
        ],
        "subscribers": {
          "follower_count": 365727,
          "paid_rough": "Thousands of paid subscribers",
          "paid_rough_int": 1000,
          "paid_tier": 1000,
          "total": 315000,
          "total_display": "315K+",
          "total_rough": "Hundreds of thousands of subscribers"
        },
        "subscriptions": [
          {
            "membership_state": "free_signup"
          }
        ],
        "url": "https://substack.com/@pragmaticengineer"
      }
    ]
  },
  "msg": "success"
}

Changes

No recorded changes to this operation across all 4 revisions of this API.