Skip to content
Get Medium latest articles in JSON format
JavaScript
Branch: master
Clone or download
Latest commit e6f5654 May 1, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Initial commit Nov 18, 2017
LICENSE Initial commit Nov 18, 2017
README.md Update readme. Nov 19, 2017
index.js Auto add '/' to endpoints. Nov 19, 2017
package.json Bump 0.0.3 May 2, 2018
server.js ORIGIN env variable. Nov 19, 2017

README.md

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'.
You can’t perform that action at this time.