podcast-index-api

Podcast Index API Javascript library

A Podcast Index API library for Node.js

Homepage | Source | npm

Installation

Install with npm

npm install podcast-index-api --save

Configuration

Sign up for API credentials here: https://api.podcastindex.org/

Description of API endpoints, arguments and returned data: https://podcastindex-org.github.io/docs-api/

Require the lib from your javascript file

const api = require('podcast-index-api')("YOUR_API_KEY_HERE", "YOUR_API_SECRET_HERE")

Usage

Using Async/Await

const results = await api.searchByTerm('Joe Rogan Experience')

Using Promise

api.searchByTerm('Joe Rogan Experience').then(results => { console.log(results) })

Functions

• Custom
  • Use for endpoints that don't have a specific function or if the function doesn't accept an argument for a desired parameter.
    • custom(path: String, queries: Object)
• Search
  • searchByTerm(q: String, val: String, clean: Boolean, fullText: Boolean)
  • searchByTitle(q: String, val: String, clean: Boolean, fullText: Boolean)
  • searchEpisodesByPerson(q: String, fullText: Boolean)
• Podcasts
  • podcastsByFeedUrl(feedUrl: String)
  • podcastsByFeedId(feedId: Number)
  • podcastsByFeedItunesId(itunesId: Number)
  • podcastsByGUID(guid: Number)
  • podcastsByTag()
  • podcastsTrending(max: Number, since: Number, lang: String, cat: String, notcat: String)
  • podcastsDead()
• Episodes
  • episodesByFeedId(feedId: Number, since: Number, max: Number, fullText: Boolean)
  • episodesByFeedUrl(feedUrl: String, since: Number, max: Number, fullText: Boolean)
  • episodesByItunesId(itunesId: Number, since: Number, max: Number, fullText: Boolean)
  • episodesById(id: Number, fullText: Boolean)
  • episodesRandom(max: Number, lang: String, cat: String, notcat: String, fullText: Boolean)
• Recent
  • recentFeeds(max: Number, since: Number, cat: String, lang: String, notcat: String)
  • recentEpisodes(max: Number, excludeString: String, before: Number, fullText: Boolean)
  • recentNewFeeds(max: Number, since: Number)
  • recentSoundbites(max: Number)
• Value
  • valueByFeedUrl(feedUrl: String)
  • valueByFeedId(feedId: Number)
• Categories
  • categoriesList()
• Notify Hub
  • hubPubNotifyById(feedId: Number)
  • hubPubNotifyByUrl(feedUrl: string)
• Add
  • addByFeedUrl(feedUrl: String, chash: String, itunesId: Number)
  • addByItunesId(itunesId: Number)