Medium-story NPM

medium-story

medium-story is a package used to fetch medium stories.

Features

Fetch stories from medium.com, by rss feed.
Works in both browser and node environment.
Typescript support.

Usage

Node

import getMediumStories from 'medium-story'

async someFunc () {
    const stories = await getMediumStories('Your-Medium-Username')

    for (const story of stories.items) {
        console.log(story.title)
        // title: string;
        // link: string;
        // pubDate: Date;
        // content: string;
        // creator: string;
        // guid: string;
        // categories: string[];
        // isoDate: Date;
    }
}

Browser

import getMediumStories from 'medium-story'

async someFunc () {
    const stories = await getMediumStories('Your-Medium-Username', { cors: true })

    for (const story of stories.items) {
        console.log(story.title)
        // title: string;
        // link: string;
        // pubDate: Date;
        // content: string;
        // creator: string;
        // guid: string;
        // categories: string[];
        // isoDate: Date;
    }
}

Types

export interface Story {
    title: string;
    link: string;
    pubDate: Date;
    content: string;
    creator: string;
    guid: string;
    categories: string[];
    isoDate: Date;
}
export interface StoriesResult {
    items: Story[];
    feedUrl: string;
    image: {
        link: string;
        url: string;
        title: string;
    };
    title: string;
    description: string;
    webMaster: string;
    generator: string;
    link: string;
    lastBuildDate: Date;
}
declare type corsFunc = (url: string) => string;
export interface getStoriesOptions {
    cors?: boolean | corsFunc;
    timeout?: number;
}
export default function getStories(username: string, options?: getStoriesOptions): Promise<StoriesResult>;
export {};