medium website screenshot

medium

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

medium publishes 6 APIs on the APIs.io network, including Authorization API, Images API, Posts API, and 3 more.

The medium catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

medium’s developer surface includes authentication, engineering blog, and 7 more developer resources.

🌐 Visit website 📡 Source on GitHub
41.3/100 thin ▬ flat Agent 38/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
6 APIs

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 41.3/100 · thin
Contract Quality 14.7 / 25
Developer Ergonomics 2.6 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.1 / 13
Governance 7.0 / 12
Discoverability 5.0 / 10
Agent readiness — 38/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/medium: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

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.

Open Collections 2

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Medium OAuth2 API

OPEN COLLECTION

Medium REST API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Medium Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Medium Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Medium Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Medium Context

0 classes · 5 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

medium API Rules

5 rules · 3 warnings 2 info

SPECTRAL

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

Medium Post

14 properties

JSON SCHEMA

Medium Publication

6 properties

JSON SCHEMA

Medium User

5 properties

JSON SCHEMA

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Medium Authentication

http · 1 scheme

SECURITY

Medium Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Medium Agentic Access

9 operations · 5 acting

9 operations · 5 acting

AGENTIC

Resources

Documentation 3

Reference material describing how the API behaves

JSONSchema
JSONSchema
 JSONSchema
JSONSchema
 JSONSchema
JSONSchema

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

JSONLD
JSONLD

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication

Company 2

The organization behind the API

LinkedIn
LinkedIn
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: medium
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/medium.png
url: https://raw.githubusercontent.com/api-evangelist/medium/refs/heads/main/apis.yml
apis:
- aid: medium:medium-authorization-api
  name: medium Authorization API
  description: Endpoints for initiating the OAuth2 authorization flow by redirecting users to Medium's authorization page.
  humanURL: https://github.com/Medium/medium-api-docs
  baseURL: https://api.medium.com/v1
  tags:
  - Authorization
  properties:
  - type: OpenAPI
    url: openapi/medium-authorization-api-openapi.yml
  - type: Documentation
    url: https://github.com/Medium/medium-api-docs
  - type: Documentation
    url: https://github.com/Medium/medium-api-docs#2-authentication
- aid: medium:medium-images-api
  name: medium Images API
  description: Operations for uploading images to Medium for use in posts. Supports JPEG, PNG, GIF, and TIFF formats.
  humanURL: https://github.com/Medium/medium-api-docs
  baseURL: https://api.medium.com/v1
  tags:
  - Images
  properties:
  - type: OpenAPI
    url: openapi/medium-images-api-openapi.yml
  - type: Documentation
    url: https://github.com/Medium/medium-api-docs
  - type: Documentation
    url: https://github.com/Medium/medium-api-docs#2-authentication
- aid: medium:medium-posts-api
  name: medium Posts API
  description: Operations for creating new posts on a user's profile or within a publication, supporting HTML and Markdown
    content formats.
  humanURL: https://github.com/Medium/medium-api-docs
  baseURL: https://api.medium.com/v1
  tags:
  - Posts
  properties:
  - type: OpenAPI
    url: openapi/medium-posts-api-openapi.yml
  - type: Documentation
    url: https://github.com/Medium/medium-api-docs
  - type: Documentation
    url: https://github.com/Medium/medium-api-docs#2-authentication
- aid: medium:medium-publications-api
  name: medium Publications API
  description: Operations for listing publications a user is associated with and retrieving contributors for a given publication.
  humanURL: https://github.com/Medium/medium-api-docs
  baseURL: https://api.medium.com/v1
  tags:
  - Publications
  properties:
  - type: OpenAPI
    url: openapi/medium-publications-api-openapi.yml
  - type: Documentation
    url: https://github.com/Medium/medium-api-docs
  - type: Documentation
    url: https://github.com/Medium/medium-api-docs#2-authentication
- aid: medium:medium-tokens-api
  name: medium Tokens API
  description: Endpoints for exchanging authorization codes for access tokens and refreshing expired access tokens.
  humanURL: https://github.com/Medium/medium-api-docs
  baseURL: https://api.medium.com/v1
  tags:
  - Tokens
  properties:
  - type: OpenAPI
    url: openapi/medium-tokens-api-openapi.yml
  - type: Documentation
    url: https://github.com/Medium/medium-api-docs
  - type: Documentation
    url: https://github.com/Medium/medium-api-docs#2-authentication
- aid: medium:medium-users-api
  name: medium Users API
  description: Operations for retrieving authenticated user profile information including username, name, URL, and avatar
    image.
  humanURL: https://github.com/Medium/medium-api-docs
  baseURL: https://api.medium.com/v1
  tags:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/medium-users-api-openapi.yml
  - type: Documentation
    url: https://github.com/Medium/medium-api-docs
  - type: Documentation
    url: https://github.com/Medium/medium-api-docs#2-authentication
common:
- type: AgenticAccess
  url: agentic-access/medium-agentic-access.yml
- type: DomainSecurity
  url: security/medium-domain-security.yml
- type: Authentication
  url: authentication/medium-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/medium-com
- type: JSONLD
  url: json-ld/medium-context.jsonld
- type: JSONSchema
  url: json-schema/medium-post-schema.json
- type: JSONSchema
  url: json-schema/medium-user-schema.json
- type: JSONSchema
  url: json-schema/medium-publication-schema.json
- url: https://medium.com/feed/blog
  type: Blog
modified: '2026-05-19'
description: Documentation for Medium's OAuth2 API. Contribute to Medium/medium-api-docs development by creating an account
  on GitHub.