Substack Публикации API
Получает публикации любого издания Substack по его URL или одну публикацию по URL (…/p/slug), чтобы получить только эту статью. Возвращает заголовок, подзаголовок, дату публикации, статус платного доступа, число слов, вовлечённость (реакции, комментарии, restack), профиль автора, данные об издании, полный текст статьи в виде текста, HTML и Markdown и, по желанию, ветки комментариев.
2,62 USD/1 тыс. результатов, оплата за запрос, без подписки.
Why roadmaps are guesses
Sep · Priya Nakamura
The three-question standup
A shorter standup that actually surfaces risk
PaidSep · Priya Nakamura
Ask me anything: hiring your first PM
Reader questions from last week's thread
Sep · Priya Nakamura
Clearheaded
Recommendations
{"postId": "148302911","title": "Why roadmaps are guesses","url": "https://www.clearheaded.blog/p/why-roadmaps-are-guesses","slug": "why-roadmaps-are-guesses","postType": "newsletter","createdUtc": 1758585600,"wordcount": 2140,"authorName": "Priya Nakamura",... ещё полей: 22}
Цены
Цена API Substack Публикации
Попробовать
Получите Substack Публикации одним запросом
В этом примере показано полей: 58 из 69. Все поля
{
"found": true,
"data": {
"items": [
{
"postId": "148302911",
"title": "Why roadmaps are guesses",
"url": "https://www.clearheaded.blog/p/why-roadmaps-are-guesses",
"slug": "why-roadmaps-are-guesses",
"postType": "newsletter",
"createdUtc": 1758585600,
"wordcount": 2140,
"authorName": "Priya Nakamura",
"authorHandle": "priyanakamura",
"contentStatus": "full",
"text": "Every roadmap I have shipped was a guess with a deadline attached.",
"publication": {
"id": "pub_5521",
"name": "Clearheaded",
"url": "https://www.clearheaded.blog",
"subdomain": "clearheaded",
"customDomain": "www.clearheaded.blog",
"description": "Notes on building things without lying to yourself.",
"image": "https://substackcdn.com/image/fetch/clearheaded/logo.png",
"language": "en",
"paymentsEnabled": true,
"subscriberCount": 38400
},
"comments": [
{
"commentId": "c_88213",
"text": "This matches every planning meeting I have sat through for a decade.",
"createdUtc": 1758600000,
"authorName": "Devon Okafor",
"authorHandle": "devonokafor",
"authorUrl": "https://substack.com/@devonokafor",
"authorImage": "https://substackcdn.com/image/fetch/clearheaded/devon-avatar.png",
"reactionCount": 44,
"restackCount": 2,
"isPinned": true,
"isAuthor": false,
"replies": [
{
"commentId": "c_88240",
"text": "Glad it landed. Curious how your team names the guess out loud.",
"createdUtc": 1758603600,
"authorName": "Priya Nakamura",
"authorHandle": "priyanakamura",
"authorUrl": "https://www.clearheaded.blog/people/priya-nakamura",
"authorImage": "https://substackcdn.com/image/fetch/clearheaded/priya-avatar.png",
"reactionCount": 12,
"restackCount": 0,
"isPinned": false,
"isAuthor": true
}
]
}
]
},
{
"postId": "148190442",
"title": "The three-question standup",
"url": "https://www.clearheaded.blog/p/the-three-question-standup",
"slug": "the-three-question-standup",
"subtitle": "",
"description": "A shorter standup that actually surfaces risk",
"postType": "newsletter",
"createdUtc": 1757980800,
"isPaid": true,
"language": "en",
"wordcount": 1420,
"reactionCount": 501,
"commentCount": 29,
"replyCount": 6,
"restackCount": 18,
"authorName": "Priya Nakamura",
"authorHandle": "priyanakamura",
"authorUrl": "https://www.clearheaded.blog/people/priya-nakamura",
"contentStatus": "preview_only",
"text": "Most standups answer the same three questions badly. Here is a version that takes six minutes and actually works...",
"publication": {
"id": "pub_5521",
"name": "Clearheaded",
"url": "https://www.clearheaded.blog",
"subdomain": "clearheaded"
},
"comments": []
},
{
"postId": "148075310",
"title": "Ask me anything: hiring your first PM",
"url": "https://www.clearheaded.blog/p/ask-me-anything-hiring-your-first-pm",
"slug": "ask-me-anything-hiring-your-first-pm",
"subtitle": "Reader questions from last week's thread",
"description": "Reader questions from last week's thread",
"postType": "thread",
"createdUtc": 1757376000,
"isPaid": false,
"language": "en",
"wordcount": 640,
"reactionCount": 203,
"commentCount": 41,
"replyCount": 9,
"restackCount": 5,
"authorName": "Priya Nakamura",
"authorHandle": "priyanakamura",
"authorUrl": "https://www.clearheaded.blog/people/priya-nakamura",
"contentStatus": "metadata_only",
"publication": {
"id": "pub_5521",
"name": "Clearheaded",
"url": "https://www.clearheaded.blog",
"subdomain": "clearheaded"
},
"comments": []
}
]
}
}Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.
Справочник
Один запрос, один формат ответа.
Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.
Проверено 2026-11-19 · доступность и задержка измерены за 30d
Тело запроса
JSON, отправляется на этот эндпоинт.
- urlstring
https://www.clearheaded.blog
Либо URL издания Substack или собственный домен, чтобы получить его последние публикации (например, https://www.astralcodexten.com), ЛИБО URL одной публикации, чтобы получить только эту статью целиком (например, https://www.astralcodexten.com/p/your-book-review).
- contentTypeenum
Ограничить одним типом публикации или 'all' (например, newsletter).
- endDatestring
Возвращать только публикации, опубликованные в эту дату или раньше, формат YYYY-MM-DD (например, 2024-12-31). Применяется среди последних просмотренных 'limit' публикаций.
- includeCommentsboolean
Включать публичные ветки комментариев и прямые ответы на каждую публикацию (например, true).
- includeContentboolean
true
Включить полный текст статьи в виде текста, HTML и Markdown. Передайте false, чтобы получить только метаданные, это быстрее (например, false).
- limitinteger
3
Максимальное число недавних публикаций, когда передан URL издания (1-100, по умолчанию 25); игнорируется для URL одной публикации, которая всегда возвращает только её. Оплата за каждую возвращённую публикацию, поэтому меньший limit стоит дешевле.
- maxCommentsinteger
Максимальное число комментариев, собираемых на публикацию, когда 'includeComments' равно true (0-500, по умолчанию 20). Дополнительно ничего не стоит (например, 50).
- minCommentsinteger
Возвращать только публикации не менее чем с таким числом комментариев (например, 10).
- minReactionsinteger
Возвращать только публикации не менее чем с таким числом реакций (например, 100).
- minWordCountinteger
Возвращать только публикации не менее чем с таким числом слов, что отсеивает короткие заметки и объявления (например, 1000).
- onlyFreeboolean
Возвращать только бесплатные публикации (без платного доступа) (например, true).
- startDatestring
Возвращать только публикации, опубликованные в эту дату или позже, формат YYYY-MM-DD (например, 2024-01-01). Применяется среди последних просмотренных 'limit' публикаций, поэтому увеличьте 'limit', чтобы дойти до более старых периодов.
Ответ
JSON, по одному примеру значения на поле.
Post records: title, subtitle, URL, publish date, paywall status, word count, engagement (reactions, comments, restacks), author profile, publication details, the article body as text, HTML and Markdown, and comment threads when requested. Populated whenever the provider has data for the entity.
- authorBiostring
Author bio as shown on their Substack profile.
- authorHandlestring
priyanakamura
Substack handle of the post author. Populated whenever the provider has data for the entity.
- authorImagestring
Profile photo URL of the post author.
- authorNamestring
Priya Nakamura
Display name of the post author. Populated whenever the provider has data for the entity.
- authorUrlstring
Substack profile URL of the post author.
- commentCountinteger
Number of top-level comments on the post.
- contentStatusstring
full
How much of the article body this record carries: 'full' for the whole article, 'preview_only' for the public excerpt of a paywalled post, 'metadata_only' when no body was requested or available, or 'failed' when extraction failed. Read this before trusting 'text', 'html', or 'markdown'. Populated whenever the provider has data for the entity.
- createdUtcnumber
1758585600
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
- descriptionstring
Short post description, usually the subtitle or an excerpt.
- hasVoiceoverboolean
Whether the post carries a narrated audio version.
- htmlstring
Article body as HTML. Present when 'includeContent' is true and 'contentStatus' is 'full' or 'preview_only'.
- imagestring
Cover image URL.
- isPaidboolean
Whether the post is behind a paywall.
- languagestring
Two-letter language code of the post.
- markdownstring
Article body as Markdown. Present when 'includeContent' is true and 'contentStatus' is 'full' or 'preview_only'.
- podcastUrlstring
Audio URL for a podcast post or a narrated voiceover, when the post has one.
- postIdstring
148302911
Substack post identifier. Populated whenever the provider has data for the entity.
- postTypestring
newsletter
Post type (newsletter, podcast, or thread). Populated whenever the provider has data for the entity.
- reactionCountinteger
Number of reactions (likes) on the post.
- replyCountinteger
Number of replies to comments on the post.
- restackCountinteger
Number of times the post was restacked.
- slugstring
why-roadmaps-are-guesses
Post slug, the last path segment of the post URL. Populated whenever the provider has data for the entity.
- subtitlestring
Post subtitle or deck.
- textstring
Every roadmap I have shipped was a guess with a deadline attached.
Article body as plain text. Present when 'includeContent' is true and 'contentStatus' is 'full' or 'preview_only'.
- titlestring
Why roadmaps are guesses
Post title. Populated whenever the provider has data for the entity.
- updatedUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- urlstring
https://www.clearheaded.blog/p/why-roadmaps-are-guesses
Canonical post URL. Populated whenever the provider has data for the entity.
- wordcountinteger
2140
Approximate word count of the article.
Top-level comment threads on the post, each with its direct replies. Empty unless 'includeComments' is true. Replies nested more than one level deep are not returned.
- authorHandlestring
devonokafor
Substack handle of the comment author.
- authorImagestring
https://substackcdn.com/image/fetch/clearheaded/devon-avatar.png
Profile photo URL of the comment author.
- authorNamestring
Devon Okafor
Display name of the comment author.
- authorUrlstring
https://substack.com/@devonokafor
Substack profile URL of the comment author.
- commentIdstring
c_88213
Substack comment identifier.
- createdUtcnumber
1758600000
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- editedUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- isAuthorboolean
false
Whether the comment was written by the post author.
- isPinnedboolean
true
Whether the comment is pinned by the publication.
- reactionCountinteger
44
Number of reactions on the comment.
- restackCountinteger
2
Number of times the comment was restacked.
- textstring
This matches every planning meeting I have sat through for a decade.
Comment body text.
Direct replies to this comment.
- authorHandlestring
priyanakamura
Substack handle of the reply author.
- authorImagestring
https://substackcdn.com/image/fetch/clearheaded/priya-avatar.png
Profile photo URL of the reply author.
- authorNamestring
Priya Nakamura
Display name of the reply author.
- authorUrlstring
https://www.clearheaded.blog/people/priya-nakamura
Substack profile URL of the reply author.
- commentIdstring
c_88240
Substack comment identifier.
- createdUtcnumber
1758603600
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- editedUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- isAuthorboolean
true
Whether the reply was written by the post author.
- isPinnedboolean
false
Whether the reply is pinned by the publication.
- reactionCountinteger
12
Number of reactions on the reply.
- restackCountinteger
0
Number of times the reply was restacked.
- textstring
Glad it landed. Curious how your team names the guess out loud.
Reply body text.
The publication the post belongs to.
- customDomainstring
www.clearheaded.blog
Custom domain the publication is served on, when it has one.
- descriptionstring
Notes on building things without lying to yourself.
Publication tagline or hero text.
- idstring
pub_5521
Substack publication identifier.
- imagestring
https://substackcdn.com/image/fetch/clearheaded/logo.png
Publication logo URL.
- languagestring
en
Two-letter language code of the publication.
- namestring
Clearheaded
Publication name.
- paymentsEnabledboolean
true
Whether the publication sells paid subscriptions.
- subdomainstring
clearheaded
Publication subdomain on substack.com.
- subscriberCountinteger
38400
Subscriber count, when the publication publishes it.
- urlstring
https://www.clearheaded.blog
Publication home URL.
- foundboolean
true
Whether any posts were found for the request.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Вопросы и ответы
Об API Substack Публикации
AnyAPI Substack Публикации API возвращает данные Substack в виде нормализованного JSON одним вызовом POST к /v1/run/substack.posts. Получает публикации любого издания Substack по его URL или одну публикацию по URL (…/p/slug), чтобы получить только эту статью. Возвращает заголовок, подзаголовок, дату публикации, статус платного доступа, число слов, вовлечённость (реакции, комментарии, restack), профиль автора, данные об издании, полный текст статьи в виде текста, HTML и Markdown и, по желанию, ветки комментариев. AnyAPI возвращает одну нормализованную схему, какой бы источник ни ответил. Это стоит 2,62 USD за 1000 результатов, и никогда не больше 0,265 USD за один запрос, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 99,4% вызовов Substack Публикации через AnyAPI завершились успешно, медианное время ответа 2,9 с, измерено вызовов: 468.