# Substack API

按专栏、作者、文章与 Notes 区分 Substack 数据对象，说明公开摘要、评论及付费标记的读取边界，便于规划订阅内容资料的整理方式。

- Domain: social · 7 data actions
- Canonical page: https://everyinfra.com/substack-api
- Failures and empty results never form a final charge.

## Actions

### search — 关键词搜索
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: keyword

- Returns fields: id, handle, name, url, custom_domain, bio, language, subscriber_count, payments_enabled, avatar_url, cover_url, platform, author_name, author_username, top_posts

### publication — 出版物或专栏
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: id, handle, name, url, custom_domain, bio, language, subscriber_count, payments_enabled, avatar_url, cover_url, platform, author_name, author_username, top_posts

### publication_posts — 出版物文章
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Optional: content_type, since, until
- Allowed values: content_type (all_types/newsletter_posts_only/podcast_episodes_only/threads_only)

- Returns fields: id, url, title, subtitle, text, author_name, author_username, publication_name, publication_handle, publication_url, like_count, comment_count, repost_count, word_count, reading_time_minutes, post_type, audience, is_paid, podcast_url, image_url, posted_at, updated_at, tags, platform

### post — 单条内容
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: id, url, title, subtitle, text, author_name, author_username, publication_name, publication_handle, publication_url, like_count, comment_count, repost_count, word_count, reading_time_minutes, post_type, audience, is_paid, podcast_url, image_url, posted_at, updated_at, tags, platform

### comments — 评论
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: id, text, author_name, author_username, like_count, reply_count, reply_to_id, is_reply, is_pinned, is_author, posted_at, platform

### profile — 主页或对象详情
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: username

- Returns fields: user_id, username, display_name, bio, avatar_url, twitter_username, platform, publications

### notes — 文章与笔记列表
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: username

- Returns fields: id, kind, text, author_username, author_name, like_count, posted_at, platform, restacked_post, attachment_urls

## Also

- Machine catalog (no key): https://everyinfra.com/openapi.json · GET /api/v1/social/catalog
- Agents guide: https://everyinfra.com/agents.md