Nourishing Pizza Microservice

    medium-json-feed

    0.0.3 • Public • Published

    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(endpointstring, 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'.

    Install

    npm i medium-json-feed

    DownloadsWeekly Downloads

    260

    Version

    0.0.3

    License

    MIT

    Unpacked Size

    6.37 kB

    Total Files

    5

    Last publish

    Collaborators

    • frankdiox