# medium

**Canonical:** https://apis.io/providers/medium/  
**APIs profiled:** 6

Documentation for Medium's OAuth2 API. Contribute to Medium/medium-api-docs development by creating an account on GitHub.

## Kin Score — 27.3 / 100 (thin)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 27.3).

| Facet | Score |
|---|---|
| Discoverability | 50.0 |
| Contract Quality | 56.3 |
| Governance | 9.8 |
| Contract Governance | 9.8 |
| Operational Transparency | 7.9 |
| Developer Ergonomics | 14.3 |
| Commercial Clarity | 15.8 |
| Access Clarity | 15.8 |

## Agent readiness — 35.9 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | verified |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: high).

## APIs (6)

- **medium Authorization API** — Endpoints for initiating the OAuth2 authorization flow by redirecting users to Medium's authorization page.
- **medium Images API** — Operations for uploading images to Medium for use in posts. Supports JPEG, PNG, GIF, and TIFF formats.
- **medium Posts API** — Operations for creating new posts on a user's profile or within a publication, supporting HTML and Markdown content formats.
- **medium Publications API** — Operations for listing publications a user is associated with and retrieving contributors for a given publication.
- **medium Tokens API** — Endpoints for exchanging authorization codes for access tokens and refreshing expired access tokens.
- **medium Users API** — Operations for retrieving authenticated user profile information including username, name, URL, and avatar image.

## Agentic access (1)

- **Medium Agentic Access** — 9 operations · 5 acting

## Security (2)

- **Medium Authentication** — http · 1 scheme
- **Medium Domain Security** — TLSv1.3 · HSTS · DMARC

## Plans (1)

- **Medium Plans Pricing**

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/medium/). Scores are computed from the provider's own public artifacts under a published rubric.