Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub

gatsby-source-medium-users

Source plugin for pulling data into Gatsby from an unofficial Medium JSON endpoint. Unfortunately the JSON endpoint does not provide the complete stories, but only previews. If you need the complete stories, you might have a look at something like gatsby-source-rss.

This plugin is based on gatsby-source-medium. However, it fetchs more than one user, and concatenate its values.

Install

npm install --save gatsby-source-medium-users

How to use

// In your gatsby-config.js
plugins: [
  {
    resolve: `gatsby-source-medium-users`,
    options: {
      usernames: [`@username`, `@username2`] ,
      limit: 200,
    },
  },
]

Options

Usernames

Remember that if you are fetching a user, prepend your username with @.

Limit

Note: this only affects requests for users and not publications.

Limit is optional and will default to 100.

You must set a higher limit if you want more than 100 posts. If you want fewer, you can either use this setting, or add a limit parameter to your graphql query.

How to query

Get all posts with the preview image ID and the author’s name:

query {
  allMediumPost(sort: { fields: [createdAt], order: DESC }) {
    edges {
      node {
        id
        title
        virtuals {
          subtitle
          previewImage {
            imageId
          }
        }
        author {
          name
        }
      }
    }
  }
}

Get all users:

query {
  allMediumUser {
    edges {
      node {
        name
      }
    }
  }
}
© 2023 Gatsby, Inc.