{"id":14986648,"url":"https://github.com/hossain-khan/medium-api-specification","last_synced_at":"2026-03-11T17:03:06.572Z","repository":{"id":42401256,"uuid":"61995600","full_name":"hossain-khan/medium-api-specification","owner":"hossain-khan","description":"API spec for medium.com using OpenAPI Specification (aka Swagger 2.0). Generates PHP, Java, Python, Go, Android, Objective-C and many more client SDK.","archived":false,"fork":false,"pushed_at":"2021-08-12T15:05:01.000Z","size":1294,"stargazers_count":18,"open_issues_count":4,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-25T18:45:12.967Z","etag":null,"topics":["client-sdk","medium","medium-api","openapi-specification","swagger","swagger-specification"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hossain-khan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-06-26T15:34:56.000Z","updated_at":"2024-02-29T22:15:46.000Z","dependencies_parsed_at":"2022-09-10T19:40:54.375Z","dependency_job_id":null,"html_url":"https://github.com/hossain-khan/medium-api-specification","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossain-khan%2Fmedium-api-specification","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossain-khan%2Fmedium-api-specification/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossain-khan%2Fmedium-api-specification/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hossain-khan%2Fmedium-api-specification/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hossain-khan","download_url":"https://codeload.github.com/hossain-khan/medium-api-specification/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248482923,"owners_count":21111401,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["client-sdk","medium","medium-api","openapi-specification","swagger","swagger-specification"],"created_at":"2024-09-24T14:13:16.907Z","updated_at":"2026-03-11T17:03:06.508Z","avatar_url":"https://github.com/hossain-khan.png","language":"Shell","readme":"* ~UPDATE #1 - Medium.com API is no longer supported.~\n* UPDATE #2 - The API is live again, users are allowed to create their own token.\n\n------\n\u003e ~Looks like Medium does not support API access anymore. The post with API info has been taken down~ - https://blog.medium.com/welcome-to-the-medium-api-3418f956552 _(Unlisted)_\n\n------\n\n[![https://img.shields.io/badge/OpenAPI-valid-brightgreen.svg](https://img.shields.io/badge/OpenAPI-valid-brightgreen.svg)](http://online.swagger.io/validator?url=https://raw.githubusercontent.com/amardeshbd/medium-api-specification/master/medium-api-specification.yaml) [![Build Status](https://travis-ci.org/amardeshbd/medium-api-specification.svg)](https://travis-ci.org/amardeshbd/medium-api-specification)\n\nMedium.com API Specification\n================================\nThis is an unofficial API specification translated from official API documentation found at [https://github.com/Medium/medium-api-docs](https://github.com/Medium/medium-api-docs) using OpenAPI Specification _(fka [Swagger](http://swagger.io/) 2.0)_.\n\nWhy OpenAPI?\n------------------\nOpenAPI specification is an open standard, it provides variety of support for generating both server and client code for different languages and frameworks. See [Swagger Tools](http://swagger.io/tools/) for more information.\n\nPreview/Test API\n--------------------\nBest way to preview or test API is using **Swagger UI**, **Swagger Editor** or **Postman**. \n\u003e NOTE: You should generate **self-issued-access-tokens** by following instruction on [official-guide](https://github.com/Medium/medium-api-docs#22-self-issued-access-tokens) to access API endpoints.\n\n * `Swagger UI` **(Recommended)** - Good for preview API doc. You can [download](https://github.com/swagger-api/swagger-ui) Swagger UI distribution, or open their **[demo](http://petstore.swagger.io/)** site and load the specification URI ([https://raw.githubusercontent.com/amardeshbd/medium-api-specification/master/medium-api-specification.yaml](https://raw.githubusercontent.com/amardeshbd/medium-api-specification/master/medium-api-specification.yaml))\n * `ReDoc` **(Mobile Device Friendly)** - ReDoc is another API spec viewer built by [Rebilly](https://github.com/Rebilly/ReDoc). **[Preview Medium API](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/amardeshbd/medium-api-specification/master/medium-api-specification.yaml)** in Redoc. _(Supports responsive design for both desktop and mobile devices)_\n * `Swagger Editor` - Good for preview, live editor support and API client library code generation support. Open their **[swagger editor](http://editor.swagger.io/)** and load the URL specification above.\n * `Postman` - Good for preview and testing API endpoints. More info at [https://www.getpostman.com/](https://www.getpostman.com/)\n\n### Generating Client SDK\nThe [swagger-codegen](https://github.com/swagger-api/swagger-codegen) tool can generate client-sdk for different languages. \n\nBased on [code generator](https://generator.swagger.io) service, following languages are [supported](https://generator.swagger.io/api/gen/clients) by the client generator.\n\u003e \"akka-scala\", \"android\", \"async-scala\", \"clojure\", \"cpprest\", \"csharp\", \"CsharpDotNet2\", \"cwiki\", \"dart\", \"dynamic-html\", \"flash\", \"go\", \"groovy\", \"html\", \"html2\", \"java\", \"javascript\", \"javascript-closure-angular\", \"jmeter\", \"objc\", \"perl\", \"php\", \"python\", \"qt5cpp\", \"ruby\", \"scala\", \"swagger\", \"swagger-yaml\", \"swift\", \"tizen\", \"typescript-angular\", \"typescript-angular2\", \"typescript-fetch\", \"typescript-node\"\n\n\nHere are few examples: \n * Android _(with java based retrofit client library)_: [medium-api-android-sample](https://github.com/amardeshbd/medium-api-android-sample)\n * Android _(with java based retrofit+RxJava client library)_ : [android-daily-headlines](https://github.com/amardeshbd/android-daily-headlines) - Uses [NYTimes](https://developer.nytimes.com/) _Top Stories V2_ swagger spec to generate [client library](https://github.com/amardeshbd/android-daily-headlines/tree/develop/api-lib/src/main/java/io/swagger/client).\n\n### Screenshots\n * Swagger UI ![Swagger UI](https://github.com/amardeshbd/medium-api-specification/blob/master/resources/screenshot_openapi_swagger-ui.png)\n * Swagger Editor _(NOTE: Code generation option available here)_ ![Swagger Editor](https://github.com/amardeshbd/medium-api-specification/blob/master/resources/screenshot_openapi_swagger-editor.png)\n * Postman ![Postman](https://github.com/amardeshbd/medium-api-specification/blob/master/resources/screenshot_openapi_postman.png)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhossain-khan%2Fmedium-api-specification","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhossain-khan%2Fmedium-api-specification","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhossain-khan%2Fmedium-api-specification/lists"}