A Gatsby plugin to load podcast episodes from the [Simplecast API](https://help.simplecast.com/en/articles/2724796-simplecast-2-0-api).
## Installation
[](http://prettier.io)
```bash
$ npm i @sergeysova/gatsby-source-simplecast
```
OR
```bash
$ yarn add @sergeysova/gatsby-source-simplecast
```
## Usage
In your `gatsby-config.js` file, load in the plugin along with the parameters of which podcast episodes to load:
```javascript
module.exports = {
plugins: [
{
resolve: '@sergeysova/gatsby-source-simplecast',
options: {
token: 'abcdefghijklmnopqrstuvwxyz1234567890',
podcastId: 'abc123de-456f-gh78-90ij-klmn1234opqr',
},
},
],
};
```
In your page, construct a query to get the data you need from the API.
```js
import React from 'react';
import { graphql } from 'gatsby';
import Img from 'gatsby-image'
import Layout from 'components/Layout';
// Data from the pageQuery below is available as props to your page component!
const PodcastPage = ({
data: {
allSimplecastEpisode: { edges: episodes },
},
}) => {
return (
);
};
export const pageQuery = graphql`
query PodcastPageQuery {
allSimplecastEpisode {
edges {
node {
id
slug
enclosureUrl
number
publishedAt(formatString: "MMMM D, Y")
title
description
image {
childImageSharp {
fixed(width: 300) {
...GatsbyImageSharpFixed
}
}
}
}
}
}
}
`;
export default PodcastPage;
```
### Options API
| Option | Type | Description | Default |
| :--------- | :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------- | :------ |
| token | `string` (required) | Simplecast API key. See the [Simplecast API documentation](https://help.simplecast.com/en/articles/2724796-simplecast-2-0-api) for details. | |
| podcastId | `string` (required) | The ID of the podcast you want to fetch. The podcast ID can be found in the URL from your Simplecast dashboard under podcast episode settings. | |
| fetchLimit | `number` | The maximum number of episodes retrieved. | `99` |
---
_Source: https://npm.io/package/@sergeysova/gatsby-source-simplecast · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
