Recent posts of any Substack publication (or one post by URL): metadata, paywall status, engagement, author and the article body as HTML, Markdown and text.
1 credit/ call
Never more than 19 credits a call.
You only pay when data comes back.
curl -X POST "https://api.primaryapi.com/v1/run/substack.posts" \
-H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://thezvi.substack.com","limit":5}'{
"output": {
"found": true,
"data": {
"nextCursor": "<string | null>",
"items": [
{
"slug": "<string | null>",
"title": "<string | null>",
"wordcount": "<integer | null>",
"isPaid": "<boolean | null>", …
}
]
}
},
"credits": 1
}Input and output
12 fields
https://thezvi.substack.com.5.limit posts scanned.limit posts scanned.29 fields
limit to scan further back)Good to know
Paid posts only expose the free preview (contentStatus "truncated").
Unknown URL? It comes back as not found, not as an error.
Terms of use. Newsletter bodies are copyrighted by their authors. Only content a logged-out reader can see is returned (paid posts are truncated). Customers must have the rights required for their use.
The same key and credits work for every API.