Medium API
Medium REST API — programmatic post creation, cross-posting, and publication management on Medium's general-audience writing platform, enabling agents to publish articles and manage drafts via OAuth-authenticated endpoints.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
GDPR compliant. TLS enforced. OAuth 2.0 with scopes. US data processing. No SOC2. API is minimal maintenance mode — security posture unclear. Self-issued tokens are account-scoped with no granularity.
⚡ Reliability
Best When
You need to publish general-interest or crossover tech/general content to a broad audience and already have a Medium following.
Avoid When
You need a fully-featured CMS API — Medium's API is minimal and has been in maintenance mode for years; use Ghost or WordPress instead.
Use Cases
- • Agents cross-posting technical or general-interest articles to Medium for broader non-developer audience reach
- • Content distribution — agents publishing the same article to multiple platforms with Medium as one channel
- • Draft creation — agents generating post drafts for human review before publishing to Medium audience
- • Publication posting — agents contributing articles to specific Medium publications with editorial workflows
- • Author profile management — agents querying author stats and post performance metrics
Not For
- • Developer-specific content — DEV.to and Hashnode have better-targeted developer audiences
- • High-volume publishing — Medium API is limited and may throttle aggressive automation
- • Paywalled content management — Medium partner program requires human interaction to configure
Interface
Authentication
OAuth 2.0 for user-level access with basicProfile, listPublications, publishPost, uploadImage scopes. Self-issued access tokens available for personal use without OAuth flow. Tokens don't expire for self-issued. OAuth tokens last 60 days.
Pricing
API access is free. Medium Partner Program (monetization) is separate from API access. No pricing model for API usage itself.
Agent Metadata
Known Gotchas
- ⚠ Medium API has been effectively abandoned since 2019 — limited new features and minimal maintenance
- ⚠ Rate limits are undocumented — aggressive publishing triggers spam detection and account suspension
- ⚠ No DELETE endpoint — posts cannot be deleted via API; only via web UI
- ⚠ Publication posting requires prior acceptance as contributor — API cannot request publication access
- ⚠ Canonical URL must be set at creation time — cannot be updated after post is published
Alternatives
Full Evaluation Report
Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for Medium API.
AI-powered analysis · PDF + markdown · Delivered within 30 minutes
Package Brief
Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.
Delivered within 10 minutes
Score Monitoring
Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.
Continuous monitoring
Scores are editorial opinions as of 2026-03-06.