Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 

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'.

About

Get Medium latest articles in JSON format

Resources

License

Releases

No releases published

Packages

No packages published