medium-json-feed
v0.0.3
Published
Get Medium latest articles in JSON format
Downloads
45
Readme
Medium JSON Feed
Get Medium latest articles in JSON format
Medium's public API is quite limited and it is not possible to fetch data from browsers due to CORS issue. Use this package in your server to get JSON article list from Medium or fork and deploy this minimum server to Heroku or another PaaS.
Installation
npm install medium-json-feed --save
Usage
Gets the user/publication name and an optional callback or stream. Returns a promise.
mediumJSONFeed(endpoint: string, callback?: Function | Stream): Promise
Simple example:
const mediumJSONFeed = require('medium-json-feed');
// Usernames start with '@'
mediumJSONFeed('@my-user-name')
.then(data => ...)
.catch(data => ...);
// Publication names without '@'
mediumJSONFeed('my-publication-name', data => ...);
// Medium's top page (trending posts)
mediumJSONFeed().then(data => ...);
Other endpoint examples are @user-name/latest
, publication-name/latest
or publication-name/trending
.
The data
response contains:
data.status
: HTTP status code (number).data.error
: Error message if exists (string).data.response
: List of found articles (Array). The format is the one returned by Medium. Inspectdata.response[...].content
anddata.response[...].virtuals
for useful information.
To get the full raw response given by Medium, provide a stream:
// Raw stream pipe to stdout
mediumJSONFeed('@my-user-name', process.stdout);
// Raw stream pipe to server's response
mediumJSONFeed('@my-user-name', response);
Note: the raw output will likely contain random chacters at the beginning of the string that break JSON format.
For a full example, see server.js
file.
Live demo (hopefully)
See The Web Tub's trending articles or Mikeal Roger's latest articles.
Deploying to Heroku
- Clone this repo.
- Create a new app in your Heroku account.
- Choose GitHub deploy and select your fork.
- Set environment variables
PORT
andORIGIN
(forAccess-Control-Allow-Origin
header). - Hit 'deploy'.