medium

aid: medium
url: https://raw.githubusercontent.com/api-evangelist/medium/refs/heads/main/apis.yml
apis:
  - aid: medium:rest-api
    name: Medium REST API
    tags:
      - Blogging
      - Content
      - Posts
      - Publications
      - Publishing
      - Social Media
      - Writing
    image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
    baseURL: https://api.medium.com/v1
    humanURL: https://github.com/Medium/medium-api-docs
    properties:
      - url: https://github.com/Medium/medium-api-docs
        type: Documentation
      - type: OpenAPI
        url: openapi/medium-rest-api-openapi.yml
    description: >-
      The Medium REST API provides programmatic access to the Medium online publishing platform. Developers can
      authenticate users via OAuth2, retrieve user profile details, list publications a user is associated with, create
      posts on a user's profile or within a publication, and upload images. The API is JSON-based with all requests made
      over HTTPS to endpoints under api.medium.com/v1, enabling integrations that automate content publishing workflows
      on Medium.
  - aid: medium:oauth2
    name: Medium OAuth2 API
    tags:
      - Authentication
      - Authorization
      - Identity
      - OAuth
    image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
    baseURL: https://medium.com/m/oauth
    humanURL: https://github.com/Medium/medium-api-docs#2-authentication
    properties:
      - url: https://github.com/Medium/medium-api-docs#2-authentication
        type: Documentation
      - type: OpenAPI
        url: openapi/medium-oauth2-openapi.yml
    description: >-
      The Medium OAuth2 API enables third-party applications to authenticate and authorize users to act on their behalf
      on the Medium platform. Applications redirect users to Medium's authorization endpoint to obtain an authorization
      code, which is then exchanged for an access token and refresh token. The OAuth2 flow supports scoped permissions
      including basicProfile, publishPost, and listPublications, allowing developers to request only the level of access
      their application requires.
common:
  - 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
modified: '2026-05-19'
description: >-
  Documentation for Medium's OAuth2 API. Contribute to Medium/medium-api-docs development by creating an account on
  GitHub.