Skip to main content

Let's find some podcasts!

Project description

Podcast searcher

Search any podcast in iTunes library

PyPI Version Build Status Code Coverage Code Quality

podsearch finds podcasts via iTunes Search API.

Search parameters:

  • query - search string (name, author etc)
  • country - ISO alpha-2 country code (us, de, fr etc), default: us
  • limit - maximum number or search results, default: 5

Returned attributes for each podcast:

  • id - iTunes ID (e.g., 979020229)
  • name - podcast name (Talk Python To Me)
  • author - author name (Michael Kennedy (@mkennedy))
  • url - Apple Podcasts URL (https://podcasts.apple.com/us/podcast/id979020229)
  • feed - podcast RSS URL (https://talkpython.fm/episodes/rss)
  • category - main category (Technology)
  • image - 600x600px image URL (https://is4-ssl.mzstatic.com/image/.../600x600bb.jpg)
  • country - ISO alpha-3 country code (USA)
  • episode_count - episode count this year (26)

Installation

pip install podsearch

Usage

Search podcasts by query:

>>> import podsearch
>>> podcasts = podsearch.search("python", country="us", limit=10)
>>> podcasts[0].name
'Talk Python To Me'
>>> podcasts[0].author
'Michael Kennedy (@mkennedy)'
>>> podcasts[0].url
'https://podcasts.apple.com/us/podcast/id979020229'

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

podcast_search-0.1.1.tar.gz (2.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

podcast_search-0.1.1-py2.py3-none-any.whl (2.3 kB view details)

Uploaded Python 2Python 3

File details

Details for the file podcast_search-0.1.1.tar.gz.

File metadata

  • Download URL: podcast_search-0.1.1.tar.gz
  • Upload date:
  • Size: 2.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.25.1

File hashes

Hashes for podcast_search-0.1.1.tar.gz
Algorithm Hash digest
SHA256 507612d97c0c38a81568da256d151d935d81361e84e196aae2b8b7e4471e0357
MD5 fc7e197c5c9fb22716d613a8cbfd0c0e
BLAKE2b-256 3eba66179e277003e8e808f2567f954cbe0a6d838b1f3167c53cb0ed2dcc6271

See more details on using hashes here.

File details

Details for the file podcast_search-0.1.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for podcast_search-0.1.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 f599357bb8ab72538eec3cf5429a743d77f6b887665cea15a84e15d459bc0034
MD5 c965e645cf13a34bcb565ad91b53e38b
BLAKE2b-256 729c6ac30641c883b94c552765a2c12537407eba32b06bfda30b088661bf4814

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page