Substack
Newsletter posts, post details and newsletter search
Substack returns public newsletters and recent public post details or text; paid posts expose previews or metadata, and some custom-domain newsletters may be unavailable.
Your information
The newsletter name or web address, for example Lenny's Newsletter or lenny.substack.com.
The maximum number of posts to return, for example 20.
Example results
About the Substack tool
Substack searches public newsletters by topic, returning names, authors, descriptions, links, and displayed subscriber counts; it needs a topic.
List newsletter posts returns recent public post details for a newsletter; it needs a name or web address.
Read post returns public text and post details; it needs a post link.
Built from substack.com, johnmaartifacts.substack.com, msolney.substack.com and on.substack.com. Last checked Sep 29, 2026.
Actions
Read post
1 creditRead the text and details of a public Substack post from its link. Paid posts show only the public preview; word count may describe the whole post.
Uses Substack, johnmaartifacts.substack.com and msolney.substack.com.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Postpost | Text | Required | The link to the newsletter post, for example https://www.oneusefulthing.org/p/the-twilight-of-the-chatbots.Example: https://www.oneusefulthing.org/p/the-twilight-of-the-chatbots |
What you get
| Field | Type | Description |
|---|---|---|
Likeslikes | Number | Number of likes.Example: 799 |
Titletitle | Text | Post title.Example: The twilight of the chatbots |
Accessaccess | Text | Whether the post is free or paid.Example: Free |
Authorsauthors | List | Names of the post authors. |
Subtitlesubtitle | Text | Post subtitle, if given.Example: How work changes along the exponential |
Post Linkpost_link | Text | Link to the post.Example: https://www.oneusefulthing.org/p/the-twilight-of-the-chatbots |
Paragraphsparagraphs | List | The publicly available post text, as plain-text paragraphs. |
Word Countword_count | Number | Post word count, including gated text if the post is paid.Example: 1271 |
Comment Countcomment_count | Number | Number of comments.Example: 103 |
Published Datepublished_date | Date | Date the post was published.Example: 2026-06-30 |
Newsletter Namenewsletter_name | Text | Name of the newsletter.Example: One Useful Thing |
Cover Image Linkcover_image_link | Text | Cover image link, when present.Example: https://substackcdn.com/image/fetch/$s_!CQgP!,f_auto,q_auto:good,fl_progressive… |
Full Text Availablefull_text_available | Yes or no | Whether the full post text is publicly available.Example: Yes |
Example result
For Post: https://www.oneusefulthing.org/p/the-twilight-of-the-chatbots
{
"likes": 799,
"title": "The twilight of the chatbots",
"access": "free",
"authors": [
"Ethan Mollick"
],
"subtitle": "How work changes along the exponential",
"post_link": "https://www.oneusefulthing.org/p/the-twilight-of-the-chatbots",
"paragraphs": [
"If you feel like things are accelerating in AI, you are probably right. Better AI models from the leading American AI labs have been releasing more quickly than ever (though government interventions s…",
"But it isn't just release timing. The evidence points to accelerating capability gains as well (though the frontier stays jagged, and AIs remain weak in many places). This is especially obvious when w…",
"Another organization doing similar experiments, Epoch , recently found Opus 4.7, working on its own for 14 hours, was able to build a software package that would take 2-17 weeks of human engineering w…"
],
"word_count": 1271,
"comment_count": 103,
"published_date": "2026-06-30",
"newsletter_name": "One Useful Thing",
"cover_image_link": "https://substackcdn.com/image/fetch/$s_!CQgP!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F8215c2ac-ba16-483d-a53d-2957f2add233_1376x8…",
"full_text_available": true
}For developers
Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.
curl 'https://api.fous.com/v1/query' \
--fail-with-body --silent --show-error --max-time 180 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"api": "@substack",
"visibility": "public",
"operation": "list_newsletter_posts",
"version": 1,
"input": {
"newsletter": "lennysnewsletter.com",
"max_results": 3
},
"response": {
"format": "json"
}
}'What you can do with it
- Find public newsletters about a topic
- Compare newsletter descriptions and displayed subscriber counts
- Track recent posts from selected newsletters
- Review public post text and publication details
- Identify posts with paid access
Questions about Substack
Can I run it with my own inputs?
Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.
Can I call this Substack tool as an API?
Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.
How much does it cost?
Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.
Do I need a Substack account?
No. You only need a Fous account.
How current is the data?
Fous gets the data from substack.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.
How can I find newsletters about a topic?
Use Search newsletters with a topic to find matching public newsletters in Substack search order.
What posts has a newsletter published recently?
Use List newsletter posts with a newsletter name or web address to get recent public post details.
Can I read a post's text?
Use Read post with its link to get publicly available post text and details. Paid posts show only the public preview.