substack-feed-api
v1.0.2
Published
The Substack Feed API is a powerful and flexible API designed to fetch and parse Substack newsletter feeds, making it easier for developers to integrate Substack content into their applications. Built with TypeScript, this API leverages modern JavaScript
Downloads
15
Readme
Substack Feed API
The Substack Feed API is a powerful and flexible API designed to fetch and parse Substack newsletter feeds, making it easier for developers to integrate Substack content into their applications. Built with TypeScript, this API leverages modern JavaScript practices to provide a robust solution for accessing Substack newsletter data.
Features
- Fetch Newsletter Feeds: Easily retrieve the latest posts from any Substack newsletter.
- Parse Feed Data: Convert Substack newsletter feeds into a structured format for easy integration.
- TypeScript Support: Enjoy the benefits of TypeScript, with type definitions for all the API responses.
- Customizable: Flexible API that can be tailored to fit the needs of your application.
Getting Started
Prerequisites
- Node.js (version 20.x or higher)
- npm (latest version)
Installation
To use the Substack Feed API in your project, follow these steps:
- Install the package via npm:
npm install substack-feed-api
- Import the API into your project:
import { SubstackFeedApi } from 'substack-feed-api';
Usage
Here's a quick example to get you started:
const api = new SubstackFeedApi();
api.fetchNewsletter('your-substack-newsletter-name').then(feed => {
console.info(feed);
}).catch(error => {
console.error('Error fetching newsletter:', error);
});
Replace 'your-substack-newsletter-name'
with the name of the Substack newsletter you wish to fetch.
Development
To contribute to the Substack Feed API or run it locally for development, you will need to follow these steps:
- Clone the repository:
git clone https://github.com/rohit1901/substack-feed-api.git
- Install dependencies:
npm install
- Run the development server:
npm run dev
Building
To build the project for production, run:
npm run build
This will generate the production-ready files in the dist
directory.
Contributing
Contributions are welcome! Feel free to open an issue or submit a pull request if you have any improvements or bug fixes to suggest.
License
This project is licensed under the MIT License.