API Direct

Substack Publication Details

GET /v1/substack/publication

Get a Substack publication by subdomain, custom domain, URL or ID. Returns name, tagline, logo, author, the subscriber badge and paid-subscriber band Substack displays, bestseller tier, subscription prices, podcast flag, language, launch dates and the publication's contributors.

Cost

$0.003 per request

Free tier

50 requests/month

Parameters

publication

Publication subdomain (lenny), host (lenny.substack.com, www.lennysnewsletter.com) or any URL on it (max 500 characters). Provide either publication or publication_id.

publication_id

Numeric publication ID, as returned in publication_id. Provide either publication or publication_id.

Example Request

curl "https://apidirect.io/v1/substack/publication?publication=lenny"   -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/substack/publication",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"publication": "lenny"}
)
print(response.json())

Example Response

{
  "publication": {
    "author": "lenny",
    "author_id": "1849774",
    "author_name": "Lenny Rachitsky",
    "author_pic_url": "",
    "author_url": "https://substack.com/@lenny",
    "bestseller_tier": 10000,
    "contributors": [
      {
        "bestseller_tier": 0,
        "biography": "Student of products. I write to learn, share and meet kindred spirits ✨.  ",
        "full_name": "Kiyani",
        "is_byline_only": false,
        "profile_pic_url": "https://bucketeer-e05bbc84-baa3-437e-9518-adb32be77984.s3.amazonaws.com/public/images/48e9d3e5-91eb-41be-9701-420b01f6585f_313x321.jpeg",
        "url": "https://substack.com/@kiyani",
        "user_id": "3667529",
        "username": "kiyani"
      }
    ],
    "cover_image_url": "https://substack-post-media.s3.amazonaws.com/public/images/4a25905e-c484-4885-80fa-9c2e683e362b_592x592.png",
    "created_at": "2019-06-01 15:35:37",
    "custom_domain": "www.lennysnewsletter.com",
    "description": "Deeply researched product, growth, and career advice for product leaders, founders, and ambitious builders.\n",
    "domain": "substack.com",
    "first_post_date": "2019-06-14 15:00:48",
    "founding_plan_name": "",
    "has_chat": false,
    "has_podcast": true,
    "has_recommendations": false,
    "is_bestseller": true,
    "language": "en",
    "logo_url": "https://substackcdn.com/image/fetch/$s_!8MSN!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F…",
    "logo_url_wide": "",
    "name": "Lenny's Newsletter",
    "paid_enabled": true,
    "paid_subscriber_band": "Tens of thousands of paid subscribers",
    "paid_subscriber_floor": 10000,
    "plans": [
      {
        "amount": 20.0,
        "currency": "USD",
        "interval": "month"
      }
    ],
    "podcast": null,
    "publication_id": "10845",
    "ranking_detail": "Tens of thousands of paid subscribers",
    "sections": [],
    "source": "Substack",
    "subdomain": "lenny",
    "subscriber_count": 1200000,
    "subscriber_count_label": "1.2M+",
    "twitter_handle": "lennysan",
    "type": "newsletter",
    "url": "https://www.lennysnewsletter.com"
  }
}

Your Usage

Free tier this month

Recent Activity