Substack

Search posts and publications across Substack

Searches posts across all of Substack and returns the publications that also matched, unlike /substack/publication/posts which searches within a single publication. Set focus_publication_id to additionally receive that one publication's own matching posts in focused_posts alongside the site-wide results.

get/substack/search

Request

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

Query parameters

querystring required

Search text

pageinteger

Zero-based page, 20 posts per page

focus_publication_idinteger

Numeric publication id whose own matching posts are returned in focused_posts

focus_limitinteger

Cap on focused_posts, 1-20. Requires focus_publication_id.

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "focused_posts": [
      {
        "audience": "everyone",
        "id": 213613469,
        "type": "newsletter"
      }
    ],
    "posts": [
      {
        "audience": "everyone",
        "id": 213613469,
        "type": "newsletter"
      }
    ],
    "publications": [
      {
        "author_name": "Dylan Patel",
        "id": 6349492,
        "name": "SemiAnalysis",
        "subdomain": "semianalysis",
        "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"
        },
        "subscription": {
          "app_store_plans": [
            {
              "amount_cents": 1400,
              "currency": "usd",
              "display_price": "$14",
              "period": "month"
            }
          ],
          "founding_plan_name": "Founding Member",
          "group_discount_percent": 20,
          "payments_state": "enabled",
          "plans": [
            {
              "amount_cents": 5000,
              "currencies": [
                {
                  "amount_cents": 900,
                  "currency": "eur"
                }
              ],
              "currency": "usd",
              "id": "monthly50usd_982ddb86",
              "interval": "month",
              "interval_count": 1,
              "kind": "monthly",
              "nickname": "$50 a month"
            }
          ]
        },
        "url": "https://semianalysis.substack.com"
      }
    ],
    "query": "artificial intelligence"
  },
  "msg": "success"
}

Changes

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