API Direct
Endpoints
Search Substack Publications

Search Substack Publications

GET /v1/substack/publications

Search Substack publications by name or keyword. Returns name, URL, tagline, author, subscriber badge, paid-subscriber band, prices, bestseller tier and language for each publication.

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 publications per page
language
Two-letter language code, e.g. es, to rank publications in that language first

Example Request

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

Example Response

{
  "count": 20,
  "has_next_page": true,
  "page": 1,
  "publications": [
    {
      "author": "cryptoyall",
      "author_id": "89093778",
      "author_name": "Josh Rhodes - Crypto Y'all",
      "author_pic_url": "https://substackcdn.com/image/fetch/$s_!e6dX!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8ff3e27c-70ae-4556-9000-a84bf76e3dd3_2973x2377.jpeg",
      "author_url": "https://substack.com/@cryptoyall",
      "bestseller_tier": 0,
      "cover_image_url": "",
      "created_at": "2025-11-06 02:36:02",
      "custom_domain": "",
      "description": "Tired of feeling lost in the crypto world? We’ll teach you how the market really works—so you can spot opportunities, av…",
      "domain": "substack.com",
      "first_post_date": "2026-06-09 15:38:18",
      "founding_plan_name": "Founding Member",
      "has_chat": true,
      "has_podcast": true,
      "has_recommendations": false,
      "is_bestseller": false,
      "language": "en",
      "logo_url": "https://substackcdn.com/image/fetch/$s_!e6dX!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.…",
      "logo_url_wide": "https://substackcdn.com/image/fetch/$s_!3X7s!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F097d2cae-589f-466e-942c-e42391021862_480x254.png",
      "name": "Josh Rhodes - Crypto Y'all",
      "paid_enabled": true,
      "paid_subscriber_band": "",
      "paid_subscriber_floor": 0,
      "plans": [
        {
          "amount": 40.0,
          "currency": "USD",
          "interval": "month"
        },
        {
          "amount": 439.0,
          "currency": "USD",
          "interval": "year"
        }
      ],
      "podcast": null,
      "publication_id": "6822164",
      "ranking_detail": "Launched 4 months ago",
      "sections": [],
      "source": "Substack",
      "subdomain": "cryptoyall",
      "subscriber_count": null,
      "subscriber_count_label": "128",
      "twitter_handle": "",
      "type": "newsletter",
      "url": "https://cryptoyall.substack.com"
    }
  ],
  "query": "crypto"
}

Your Usage

Free tier this month
Loading...
Recent Activity