API Direct
Endpoints
Search Substack Users

Search Substack Users

GET /v1/substack/users

Search Substack authors and publication profiles by name or keyword. Returns handle, display name, bio, follower count, subscriber badge, bestseller tier and primary publication for each profile.

Cost
$0.003 per request
Free tier
50 requests/month

Parameters

query *
Search keyword (max 500 characters)
page
Page number, 1-4 (default: 1). 20 profiles per page

Example Request

curl "https://apidirect.io/v1/substack/users?query=lenny&page=1"   -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "count": 20,
  "has_next_page": true,
  "page": 1,
  "query": "lenny",
  "users": [
    {
      "bestseller_tier": 10000,
      "biography": "Writing • Angel investing • Advising",
      "date_joined": "2021-05-01 23:55:21",
      "follower_count": 1383966,
      "full_name": "Lenny Rachitsky",
      "is_bestseller": true,
      "leaderboard": {
        "board": "paid",
        "category": "Business",
        "category_id": 62,
        "rank": 1
      },
      "paid_subscriber_band": "Tens of thousands",
      "paid_subscriber_floor": 10000,
      "primary_publication": {
        "logo_url": "https://substack-post-media.s3.amazonaws.com/public/images/441213db-4824-4e48-9d28-a3a18952cbfc_592x592.png",
        "name": "Lenny's Newsletter",
        "publication_id": "10845",
        "subdomain": "lenny",
        "url": "https://www.lennysnewsletter.com"
      },
      "profile_pic_url": "https://bucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com/public/images/afba5161-65bb-4d99-8d6b-cce660917fa1_1540x1540.png",
      "subscriber_count": 1200000,
      "subscriber_count_label": "1.2M+",
      "twitter_handle": "lennysan",
      "url": "https://substack.com/@lenny",
      "user_id": "1849774",
      "username": "lenny"
    }
  ]
}

Your Usage

Free tier this month
Loading...
Recent Activity