Skip to main content
POST
/
api
/
substack
/
posts
/
search
/substack/posts/search
curl --request POST \
  --url https://api.anysite.io/api/substack/posts/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "publication": "<string>",
  "count": 2,
  "timeout": 300,
  "search": "<string>",
  "sort": "new"
}
'
[
  {
    "id": 123,
    "@type": "@substack_post_list_item",
    "alias": "<string>",
    "title": "<string>",
    "subtitle": "<string>",
    "preview_text": "<string>",
    "published_at": "<string>",
    "canonical_url": "<string>",
    "publication_id": 123,
    "reaction_count": 123,
    "comment_count": 123,
    "image": "<string>"
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
publication
string
required

Substack publication subdomain or custom domain

Minimum string length: 1
Examples:

"thefp.com"

"newsletter.pragmaticengineer.com"

"platformer"

​
count
integer
required

Max number of posts to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
search
string | null

Keyword to filter posts within the publication

​
sort
enum<string>
default:new

Ordering of the publication feed

Available options:
new,
top,
community

Response

Successful Response

​
id
integer
required
​
@type
string
default:@substack_post_list_item
​
alias
string | null
​
title
string | null
​
subtitle
string | null
​
preview_text
string | null
​
audience
enum<string> | null
Available options:
only_paid,
only_free,
everyone
​
type
enum<string> | null
Available options:
newsletter,
podcast,
thread
​
published_at
string | null
​
canonical_url
string | null
​
publication_id
integer | null
​
reaction_count
integer | null
​
comment_count
integer | null
​
image
string | null