Search packages, repositories and app categories

GitHub repositoryamugofjava/podcast_search

podcast_search

A simple library providing programmatic access to the iTunes search API for podcasts.

podcast_search project cover
Stars
50
Forks
31
Last push (UTC)
Apr 22, 2026
Project status
Active

Original README

English project snapshot. Visit GitHub for the latest content.

A library for searching for podcasts, parsing podcast RSS feeds and obtaining episodes details. Supports searching via iTunes and PodcastIndex.

Usage

Search for podcasts with 'widgets' in the title and find the top podcasts. Both examples limit to 10 results and are set for the United Kingdom:

import 'package:podcast_search/podcast_search.dart';

// ignore_for_file: avoid_print
void main() async {
  var search = Search();

  /// Search for podcasts with 'widgets' in the title.
  var results =
  await search.search('widgets', country: Country.unitedKingdom, limit: 10);

  /// List the name of each podcast found.
  for (var result in results.items) {
    print('Found podcast: ${result.trackName}');
  }

  /// Parse the first podcast.
  final feed = results.items[0].feedUrl;

  /// It is possible to get back a podcast with a missing feed URL, so check that.
  if (feed != null) {
    var podcast = await Feed.loadFeed(url: feed);

    /// Display episode titles.
    for (var episode in podcast.episodes) {
      print('Episode title: ${episode.title}');
    }
  }

  /// Find the top 10 podcasts in the UK.
  var charts = await search.charts(limit: 10, country: Country.unitedKingdom);

  /// List the name of each podcast found.
  for (var result in charts.items) {
    print('Episode title: ${result.trackName}');
  }
}

Supported Namespace Tags

Podcasting 2.0
  • Block
  • Chapters
  • Funding
  • GUID
  • Locked
  • Person
  • Transcripts (VTT, SRT & JSON formats)
  • Value
  • Alternate Enclosure
iTunes
  • Author
  • Episode
  • Season
Ben Hills GitHub avatar
GitHub author

Ben Hills ↗

Flutter & Java Developer. Likes to tinker with Elasticsearch.

LanguagesDart

Packages published by this repository

Dependencies used

Dependency list 8 items

How do I choose a repository?

Start with your use case, compare repository activity, and check the original project before adopting it.

  1. Search by repository name, owner or description, then narrow the results by topic.
  2. Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
  3. Read the README, license and issues on GitHub before using a project.

Sources and maintenance

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗