emmanuelagbo-4/medium-json-feed

Get Medium latest articles in JSON format

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. Inspect data.response[...].content and data.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

1. Clone this repo.
2. Create a new app in your Heroku account.
3. Choose GitHub deploy and select your fork.
4. Set environment variables PORT and ORIGIN (for Access-Control-Allow-Origin header).
5. Hit 'deploy'.