# newsletterapi

> Connect your Substack by URL and give your AI agents, your website and your backups your whole publication: posts, archive search, growth stats and more. Read-only, no logins shared.

Access: email hello@newsletterapi.io or use the form at /pricing.
Not affiliated with Substack, Inc.

## APIs
- [Posts & Archive API](https://www.newsletterapi.io/apis/posts-api): Your whole Substack archive as clean JSON, Markdown or HTML: list, get, search, tags, authors and images.
- [MCP server for AI agents](https://www.newsletterapi.io/mcp): A hosted MCP server that lets Claude, ChatGPT and other agents read your archive, learn your voice and draft with it.
- [Automatic backups](https://www.newsletterapi.io/apis/backups): Every Substack post, with images, backed up as Markdown and HTML to GitHub, Google Drive, Dropbox or S3.
- [Website embeds & content webhooks](https://www.newsletterapi.io/apis/embeds): Show your Substack posts on your own site with CORS-friendly JSON and widgets, and get a webhook when you publish.
- [Subscriber analytics from your export](https://www.newsletterapi.io/apis/analytics): Upload your Substack export and get growth, cohorts, engagement segments and source quality, via dashboard, API or MCP.
- [Import converter](https://www.newsletterapi.io/apis/import-converter): Convert Medium, Ghost, WordPress, Google Docs, Markdown or TinyLetter archives into a file for Substack's importer.

## Guides
- [How to Sync Substack Subscribers to Kit or HubSpot](https://www.newsletterapi.io/blog/sync-substack-subscribers-to-kit-or-hubspot): As of October 2026, Substack has no native integration, Zapier app or webhook for Kit or HubSpot. The reliable option is a scheduled export from Substack, then an import into Kit or HubSpot with mapped fields and a tag, plus an unsubscribe pass in both directions. Only email people in the second tool if they agreed to it, and don't send the same newsletter from both.
- [Does Substack Have Webhooks? What to Use Instead](https://www.newsletterapi.io/blog/substack-webhooks): No. As of October 2026 Substack has no webhook setting for subscriber or post events. The closest signals are the RSS feed for new posts, webhooks from your own Stripe account for paid events, anonymous sign-up events in Google Analytics or Tag Manager, and your own subscriber export for email-level changes.
- [Substack vs WordPress: Which Should Writers Use?](https://www.newsletterapi.io/blog/substack-vs-wordpress): Choose Substack if you want a free, all-in-one newsletter with built-in payments (10% of revenue plus Stripe fees) and a reader network, and you can live without custom code or an API. Choose WordPress if you want full control of design, plugins, SEO and data through its REST API, and you can handle more setup. You can migrate in either direction.
- [Substack Statistics 2026: Users, Revenue and Funding](https://www.newsletterapi.io/blog/substack-statistics): As of October 2026, Substack says it has 5 million paid subscriptions and that tens of millions of people read, watch and listen on it every week (both self-reported). It raised $100M at a reported $1.1B valuation in July 2025 (press) and keeps 10% of subscription revenue. Third parties estimate roughly $45M in annualized revenue and about 172M monthly visits to substack.com.
- [Substack RSS Feed: URL, Paid Posts and Uses](https://www.newsletterapi.io/blog/substack-rss-feed): Every Substack publication has a public RSS feed at https://yourname.substack.com/feed, or at yourdomain.com/feed on a custom domain. As of October 2026 the feeds we checked held the 20 most recent posts. Free posts carry their full HTML, and paid posts stop at the paywall with a "Read more" link.
- [Substack New Subscriber Email Has No Address? What Changed](https://www.newsletterapi.io/blog/substack-new-subscriber-notification-no-email): Around 18–20 March 2026, Substack's new free subscriber notification stopped including the subscriber's email; writers now get a generic '1 person has subscribed' message. You can still see who subscribed in the Subscribers dashboard and the CSV export, and a Publisher API key, where enabled, can look up a known email. Gmail-parsing automations broke and need a new trigger.
- [What Does the Meta Pixel Track on Substack?](https://www.newsletterapi.io/blog/substack-meta-pixel-tracking): Substack loads your Meta pixel when you paste its numeric ID in Settings → Analytics, and it reports page views, free sign-ups and paid sign-ups. In Substack's page code (observed October 2026) those appear as CompleteRegistration, Purchase and Subscribe events, with a hashed email sent by Substack. You can't add custom pixel code or your own Conversions API events.
- [Substack MCP Server: Official vs Open Source (2026)](https://www.newsletterapi.io/blog/substack-mcp-server): Substack runs an official MCP server at mcp.substack.com, but as of October 2026 it is read-only and limited to admins of Bestseller publications. Everyone else can use the Publisher API through an open-source wrapper if their publication has a key, or community servers that reuse a browser session, which carry account and terms risk.
- [Substack Integrations in 2026: What Works and What Doesn't](https://www.newsletterapi.io/blog/substack-integrations): As of October 2026, Substack has no app on Zapier, Make, n8n or Pipedream, and no webhooks. What does work: the public RSS feed, two read-only IFTTT triggers, Notes scheduling through Buffer or Typefully, GA4, Google Tag Manager and Meta or X pixels in Settings, and the export you download yourself.
- [Substack Import Held for Review or Denied? What to Do](https://www.newsletterapi.io/blog/substack-import-held-for-review): Substack screens every list import, and if its checks suggest some people didn't explicitly opt in to your publication, the list goes to its Standards & Enforcement team, which aims to review within 72 hours. Lists of contacts, leads or mixed audiences are likely to be denied. To pass, import only people who opted in, say where they signed up (with a URL), and use the signup embed for everyone else.
- [Why Does My Substack Script Get a 403 Error?](https://www.newsletterapi.io/blog/substack-api-403-error): Substack has no public write API, so scripts that post drafts, Notes or sign-ups through the dashboard's internal endpoints get 403 Forbidden or a captcha when the request doesn't come from a real logged-in browser. Public reads mostly work. Working around the block breaks Substack's Terms of Use; use RSS, your export, the Publisher API, the official MCP or Buffer for Notes instead.
- [Why Don't My Substack and Stripe Numbers Match?](https://www.newsletterapi.io/blog/substack-and-stripe-numbers-dont-match): They measure different things. Substack shows annualised revenue (GARR) and every paid-access subscriber, including comps, gifts and iOS in-app subscribers, while Stripe shows actual card charges, net of fees and in your account currency. Coupons, refunds, failed payments and payout timing widen the gap, so reconcile by period and by subscriber type.
- [Substack Analytics Explained: Every Dashboard Metric](https://www.newsletterapi.io/blog/substack-analytics-explained): Substack's stats live in Home, Posts, Stats and Sources. They cover views, open rate, engagement, new free and paid subscribers per post, traffic sources, retention cohorts and churn. For anything they don't answer, such as which readers are going quiet, export your subscriber CSV and analyse it yourself, or add Google Analytics 4 in Settings.
- [Substack Account Suspended? How to Protect Your Subscribers](https://www.newsletterapi.io/blog/substack-account-suspended-protect-subscribers): If Substack suspends your account, writers report you can't run an export until the suspension is lifted, so the only real protection is a copy you made beforehand. Appeal by emailing tos@substackinc.com; Substack's terms say it will respond within 3 business days. Before anything happens, export your subscriber CSV and full archive on a schedule, keep posts on your own disk, and use a custom domain.
- [How to Publish to Substack from Markdown or Obsidian](https://www.newsletterapi.io/blog/publish-to-substack-from-markdown): Substack's post editor does not support Markdown as of October 2026, so the reliable route is to render your Markdown first and paste the formatted result, then fix images, code, equations and tables with the editor's own blocks. For whole archives, Substack's importer can read an RSS feed. Fully automated posting needs unofficial tools that use your login, which Substack's terms put at risk.
- [Newsletter Platforms With an API: 2026 Comparison](https://www.newsletterapi.io/blog/newsletter-platforms-with-an-api): As of October 2026, beehiiv, Kit, Ghost, Buttondown, Mailchimp and MailerLite all offer self-serve APIs that can create subscribers, and each has webhooks, though beehiiv and Ghost put webhooks on paid plans. Substack is the outlier: its official surfaces are read-only (a gated Publisher API and a Bestseller-only MCP), with no webhooks and no subscriber-create endpoint.
- [Newsletter MCP Servers Compared: beehiiv, Kit, Mailchimp](https://www.newsletterapi.io/blog/newsletter-mcp-servers-compared): As of October 2026, beehiiv, Kit and MailerLite run official hosted MCP servers with OAuth and read/write tools, with beehiiv and Kit gating writes or access to paid plans. Mailchimp's first-party MCP covers its transactional product, Ghost and Buttondown rely on community servers, and Substack's official MCP is read-only and limited to Bestseller admins.
- [Import Posts to Substack: WordPress, Medium and Markdown](https://www.newsletterapi.io/blog/import-posts-to-substack): Substack's post importer (Settings → Import/Export → Import posts) takes a URL from Medium, Ghost, WordPress, Mailchimp, beehiiv, Seeking Alpha, Tumblr or Blogspot, or any RSS feed. Mailchimp, Webflow and Tumblr need an uploaded export. Markdown and Google Docs have no direct importer, so you either paste each post into the editor or turn them into a feed first.
- [How to Back Up Your Substack: Posts, List and Images](https://www.newsletterapi.io/blog/how-to-back-up-your-substack): To back up a Substack, open Settings → Exports and click "Create new export" to get a zip of your posts, subscriber list and related statistics, then export the subscriber CSV from the Subscribers page. Keep both copies outside Substack and repeat on a schedule, because writers report that a suspended account cannot run an export.
- [Facebook Lead Ads to Substack: How to Get Leads In](https://www.newsletterapi.io/blog/facebook-lead-ads-to-substack): As of October 2026 there is no official Substack API, Zapier app or Meta integration that adds lead-form contacts to Substack. What works: send ad traffic to your Substack /subscribe page or a landing page with Substack's signup embed, and track it with the Meta pixel in Substack's Analytics settings. With Instant Forms, collect explicit consent and route leads to Substack's own subscribe flow.
- [Export Substack Subscribers (and Move Them to Kit)](https://www.newsletterapi.io/blog/export-substack-subscribers): To export Substack subscribers, open your dashboard's Subscribers page, click the three dots above "All subscribers", choose Export and pick all columns or visible columns. You get a CSV of emails, plan types, dates and activity, but no names. Import it into Kit, Mailchimp or HubSpot only for people who opted in, and warm the list up before a big send.
- [How to Embed Substack Posts on Your Website](https://www.newsletterapi.io/blog/embed-substack-posts-on-your-website): Substack offers two official embeds. You get a single post's embed code from Share → More → Embed, and a signup-form iframe from Settings → Growth features. To show a live list of your latest posts, fetch your RSS feed on your server or at build time; a browser script can't read Substack directly, because cross-site requests are blocked.
- [Does Substack Have an API? The Honest 2026 Map](https://www.newsletterapi.io/blog/does-substack-have-an-api): Not a general one. As of October 2026 Substack offers a few narrow official surfaces: a Developer API for LinkedIn-handle profile lookups (by application), a read-only Publisher API on publications where it is enabled, and a read-only MCP server for Bestseller admins. Notes can be posted through partners Buffer and Typefully. There is no public write API for posts and no webhooks.
- [How to Connect Claude to Substack (2026 Guide)](https://www.newsletterapi.io/blog/connect-claude-to-substack): If you are an admin of a Bestseller publication, add https://mcp.substack.com/api/v1/mcp as a custom connector in Claude and sign in to Substack; it gives Claude read-only access to your stats. Everyone else can give Claude their own exports and RSS feed, use a Publisher API key if they have one, and use Buffer or Typefully for Notes. Let Claude draft; you publish.
- [How to Add Subscribers to Substack Without Getting Blocked](https://www.newsletterapi.io/blog/add-subscribers-to-substack): To add subscribers to Substack, go to Subscribers → Add subscribers and type emails or upload a .csv, .xlsx or .ods file. Everyone on the list must have explicitly opted in to hear from you: Substack screens imports, may hold a list for human review (usually within 72 hours) and denies lists of contacts or leads. For new people, use your /subscribe link or the embeddable signup form.

## Optional
- [Full text for LLMs](https://www.newsletterapi.io/llms-full.txt)
- [RSS](https://www.newsletterapi.io/feed.xml)
- [Sitemap](https://www.newsletterapi.io/sitemap.xml)