Endpoint Playground

Try the Substack Publication Posts API

Test Crawlora's Substack Publication Posts API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /substack/publication/posts
Platform: Substack
Auth: apiKey
Credits: 3 credits/request
Required params: publication
Common optional params: search, sort, offset, limit

Substack Publication Posts API documentation Substack platform page Crawlora API pricing Try List Substack categories API Try Substack Category Rankings API Try Substack Explore Feed API Try Substack Leaderboard API Try Get one public Substack Note API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/substack/publication/posts?publication=<publication>&sort=new" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
publication	string	Yes		Publication subdomain or custom domain
search	string	No		Full-text filter over the publication's own posts
sort	string	No	new	Archive ordering
offset	integer	No		Zero-based row offset
limit	integer	No		Rows per page, 1-50

Example JSON response

{
  "code": 200,
  "data": {
    "publication": "semianalysis.substack.com",
    "sort": "new",
    "offset": 0,
    "limit": 12,
    "posts": [
      {
        "id": 213613469,
        "title": "Korea's Trillion-Dollar Sovereign AI Investment",
        "slug": "koreas-trillion-dollar-sovereign",
        "url": "https://newsletter.semianalysis.com/p/koreas-trillion-dollar-sovereign",
        "type": "newsletter",
        "audience": "only_paid",
        "published_at": "2026-09-01T20:14:32.560Z",
        "paywalled": true,
        "comment_count": 1,
        "reaction_count": 162
      }
    ]
  },
  "msg": "success"
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestsubstack.postsResponseDocSubstack

GET /substack/publication/posts

List a Substack publication's public post archive

Returns one page of a publication's public post archive with title, subtitle, canonical URL, publish date, engagement counts, and whether each post is paywalled. search filters the publication's own posts full-text; a query with no matches returns an empty list rather than the unfiltered archive.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

publication

requiredstring

Publication subdomain or custom domain

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "data": {
    "publication": "semianalysis.substack.com",
    "sort": "new",
    "offset": 0,
    "limit": 12,
    "posts": [
      {
        "id": 213613469,
        "title": "Korea's Trillion-Dollar Sovereign AI Investment",
        "slug": "koreas-trillion-dollar-sovereign",
        "url": "https://newsletter.semianalysis.com/p/koreas-trillion-dollar-sovereign",
        "type": "newsletter",
        "audience": "only_paid",
        "published_at": "2026-09-01T20:14:32.560Z",
        "paywalled": true,
        "comment_count": 1,
        "reaction_count": 162
      }
    ]
  },
  "msg": "success"
}

Endpoint details

Method: GET
Path: /substack/publication/posts
Authentication: apiKey
Credit cost: 3 credits/request
Platform: Substack
Parameters: 6 documented fields

Request parameters

publication:querysearch:querysort:queryoffset:querylimit:queryx-api-key:header

Response schema fields

codedatadata.limitdata.offsetdata.postsdata.posts[].audiencedata.posts[].comment_countdata.posts[].cover_image_urldata.posts[].descriptiondata.posts[].iddata.posts[].paywalleddata.posts[].published_at

Sample response summary

{
  "code": 200,
  "data": {
    "publication": "semianalysis.substack.com",
    "sort": "new",
    "offset": 0,
    "limit": 12,
    "posts": [
      {
        "id": 213613469,
        "title": "Korea's Trillion-Dollar Sovereign AI Investment",
        "slug": "koreas-trillion-dollar-sovereign",
        "url": "https://newsletter.semianalysis.com/p/koreas-trillion-dollar-sovereign",
        "type": "newsletter",
        "audience": "only_paid",
        "published_at": "2026-09-01T20:14:32.560Z",
        "paywalled": true,
        "comment_count": 1,
        "reaction_count": 162
      }
    ]
  },
  "msg": "success"
}

cURL example

curl "https://api.crawlora.net/api/v1/substack/publication/posts?publication=<publication>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing List Substack categories List the publications ranked in one Substack category Browse the public Substack Explore surface List a Substack category's bestseller leaderboard Get one public Substack Note

Endpoint Playground

Try the Substack Publication Posts API

Endpoint facts

Method: GET
API path: /substack/publication/posts
Platform: Substack
Auth: apiKey
Credits: 3 credits/request
Required params: publication
Common optional params: search, sort, offset, limit

Prefilled cURL

curl "https://api.crawlora.net/api/v1/substack/publication/posts?publication=<publication>&sort=new" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
publication	string	Yes		Publication subdomain or custom domain
search	string	No		Full-text filter over the publication's own posts
sort	string	No	new	Archive ordering
offset	integer	No		Zero-based row offset
limit	integer	No		Rows per page, 1-50

Example JSON response

{
  "code": 200,
  "data": {
    "publication": "semianalysis.substack.com",
    "sort": "new",
    "offset": 0,
    "limit": 12,
    "posts": [
      {
        "id": 213613469,
        "title": "Korea's Trillion-Dollar Sovereign AI Investment",
        "slug": "koreas-trillion-dollar-sovereign",
        "url": "https://newsletter.semianalysis.com/p/koreas-trillion-dollar-sovereign",
        "type": "newsletter",
        "audience": "only_paid",
        "published_at": "2026-09-01T20:14:32.560Z",
        "paywalled": true,
        "comment_count": 1,
        "reaction_count": 162
      }
    ]
  },
  "msg": "success"
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestsubstack.postsResponseDocSubstack

GET /substack/publication/posts

List a Substack publication's public post archive

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

publication

requiredstring

Publication subdomain or custom domain

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "data": {
    "publication": "semianalysis.substack.com",
    "sort": "new",
    "offset": 0,
    "limit": 12,
    "posts": [
      {
        "id": 213613469,
        "title": "Korea's Trillion-Dollar Sovereign AI Investment",
        "slug": "koreas-trillion-dollar-sovereign",
        "url": "https://newsletter.semianalysis.com/p/koreas-trillion-dollar-sovereign",
        "type": "newsletter",
        "audience": "only_paid",
        "published_at": "2026-09-01T20:14:32.560Z",
        "paywalled": true,
        "comment_count": 1,
        "reaction_count": 162
      }
    ]
  },
  "msg": "success"
}

Endpoint details

Method: GET
Path: /substack/publication/posts
Authentication: apiKey
Credit cost: 3 credits/request
Platform: Substack
Parameters: 6 documented fields

Request parameters

publication:querysearch:querysort:queryoffset:querylimit:queryx-api-key:header

Response schema fields

Sample response summary

{
  "code": 200,
  "data": {
    "publication": "semianalysis.substack.com",
    "sort": "new",
    "offset": 0,
    "limit": 12,
    "posts": [
      {
        "id": 213613469,
        "title": "Korea's Trillion-Dollar Sovereign AI Investment",
        "slug": "koreas-trillion-dollar-sovereign",
        "url": "https://newsletter.semianalysis.com/p/koreas-trillion-dollar-sovereign",
        "type": "newsletter",
        "audience": "only_paid",
        "published_at": "2026-09-01T20:14:32.560Z",
        "paywalled": true,
        "comment_count": 1,
        "reaction_count": 162
      }
    ]
  },
  "msg": "success"
}

cURL example

curl "https://api.crawlora.net/api/v1/substack/publication/posts?publication=<publication>" \
  -H "x-api-key: $CRAWLORA_API_KEY"