PyMedium - Unofficial Medium API
PyMedium is an unofficial Medium API written in python flask. It provides developers to access to user, post list and detail information from Medium website. This is a read-only API to access public information from Medium, you can customize this API to fit your requirements and deploy on your own server.
Installation
Before running PyMedium API, you have to clone the code from this repository, install requirements at first.
$ git clone [email protected]:enginebai/PyMedium.git
$ cd PyMedium
$ pip install -r requirements.txt
Then download web driver to driver folder from Selenium or via the command-line with curl (update {VERSION} with the latest version code and {OS} with your server operating system.
$ mkdir driver | cd driver
$ curl -O https://chromedriver.storage.googleapis.com/{VERSION}/chromedriver_{OS}.zip
$ unzip chromedriver_{OS}.zip
Usage
To run this API application, use the flask command as same as Flask Quickstart
$ export FLASK_APP=./pymedium/api.py
$ export FLASK_DEBUG=1 ## if you run in debug mode.
$ flask run
* Running on http://localhost:5000/
Documentation
Users
GET /@{username}- Get user profile
Response
{
"avatar": "1*Y7zH0UM975YmchIO86uIGA.jpeg",
"bio": "Mixtape of developer, designer and startup. Cofounder and developer of DualCores Studio. Follow my technical blog: http://enginebai.logdown.com/",
"display_name": "Engine Bai",
"facebook": "789985027713671",
"followedby_count": 445,
"following_count": 238,
"publications": [
{
"creator_user_id": "3301d32a6bba",
"description": "Stories from the mix of designer and developer. 設計與工程的交織，混搭激盪出不同的想像。",
"display_name": "DualCores Studio",
"follower_count": 302,
"image": {
"image_id": "1*DLixNgsMpK5B74na3EDucQ.png",
"original_height": 591,
"original_width": 591
},
"logo": {
"image_id": "1*DLixNgsMpK5B74na3EDucQ.png",
"original_height": 591,
"original_width": 591
},
"name": "dualcores-studio",
"post_count": 0,
"publication_id": "275e26e7c1b2",
"url": "https://medium.com/dualcores-studio"
},
...more
],
"twitter": "enginebai",
"user_id": "3301d32a6bba",
"username": "enginebai"
}
Publication
GET /{publication_name}- Get publication profile
{
"creator_user_id": "3301d32a6bba",
"description": "Stories from the mix of designer and developer. 設計與工程的交織，混搭激盪出不同的想像。",
"display_name": "DualCores Studio",
"follower_count": 302,
"image": {
"image_id": "1*DLixNgsMpK5B74na3EDucQ.png",
"original_height": 591,
"original_width": 591
},
"logo": {
"image_id": "1*DLixNgsMpK5B74na3EDucQ.png",
"original_height": 591,
"original_width": 591
},
"name": "dualcores-studio",
"post_count": 0,
"publication_id": "275e26e7c1b2",
"url": "https://medium.com/dualcores-studio"
}
Post
GET /@{username}/posts- Get user latest postsGET /{publication_name}/posts- Get publication latest postsGET /top- Get most popular today postsGET /tags/{tag}- Get tagged in popular postsGET /tags/{tag}/latest- Get tagged in latest posts
Parameters
| Name | Type | Description |
|---|---|---|
| n | integer | The count of posts to return. Default is 10. |
Response
[
{
"image_count": 14,
"post_date": 1478533474858,
"post_id": "99a3d86df228",
"preview_image": {
"image_id": "1*zhnQJhNzp-Oal1-GU1EUKw.png",
"original_height": 412,
"original_width": 608
},
"read_time": 7.74811320754717,
"recommend_count": 351,
"response_count": 10,
"title": "Make an android custom view, publish and open source.",
"url": "https://medium.com/dualcores-studio/make-an-android-custom-view-publish-and-open-source-99a3d86df228",
"word_count": 1669
},
...more
]
Post detail
GET /post- Get the post content
Parameters
| Name | Type | Description |
|---|---|---|
| u | string | The post url to parse content. |
| format | string | (optional) The format of response, the value could be text, html, md, json, default is text. |
Response
## Simple text, json, html, markdown format
Issues
Feel free to submit bug reports or feature requests and make sure you read the contribution guideline before opening any issue.
Contributing
- Check the open/close issues or open a fresh issue for feature request or bug report with different labels (
feature/bug). - Fork this repository on GitHub to start customizing on master or new branch.
- Write a test which shows that the feature works as expected or the bug was fixeed.
- Send a pull request and wait for code review.
License
Copyright (c) 2017 Engine Bai Licensed under the MIT license.
![Hüzünlü Artemis [HuzunluArtemis]](https://avatars.githubusercontent.com/u/84624971?v=4&s=60)
25 May 07, 2022
32 Nov 21, 2022
11 Dec 19, 2022
9 Aug 25, 2022
97 Dec 21, 2022
1 Dec 10, 2021
10 Oct 09, 2022
1 Jan 08, 2022
7 Dec 16, 2022
3 Jan 07, 2022
6 Jan 26, 2022
10 Oct 05, 2022
1 Dec 13, 2021
0 Aug 24, 2022
2 Sep 04, 2022
1 Jan 16, 2022
18 Dec 24, 2022
16 Dec 14, 2022
1 Jan 01, 2022
3 Jul 28, 2022