Skip to main content

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'

Retrieve podcast by iTunes ID:

>>> import podsearch
>>> podcast = podsearch.get(979020229)
>>> podcast.name
'Talk Python To Me'

Development setup

$ python3 -m venv env
$ . env/bin/activate
$ make deps
$ tox

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Make sure to add or update tests as appropriate.

Use Black for code formatting and Conventional Commits for commit messages.

Changelog

License

MIT

Metadata

Release files for podsearch 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for podsearch 0.3.1
File Size Uploaded Provenance Actions
podsearch-0.3.1.tar.gz 8.0 kB Without provenance Details for podsearch-0.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for podsearch 0.3.1
File Interpreter ABI Platform Actions
podsearch-0.3.1-py3-none-any.whl Python 3 none any Details for podsearch-0.3.1-py3-none-any.whl

Total release size: 13.0 kB

Release files / podsearch-0.3.1.tar.gz

Download URL podsearch-0.3.1.tar.gz
Size 8.0 kB
Tags Source
SHA-256 checksum
How to use checksums
808d061c94116b28517af8140e7af324049890318a27df6892cfc832f78df420
BLAKE2b-256 checksum
How to use checksums
51a7b0fea6fbaff1fa5e99fd13051c16d8c2bc4accf527f1d4ac0b011c2dcb90
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via python-requests/2.25.1

Release files / podsearch-0.3.1-py3-none-any.whl

Download URL podsearch-0.3.1-py3-none-any.whl
Size 5.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e80ad2194020038183463fd4a065cf78aa5cbc155e0064f5cdcb00f203994fa4
BLAKE2b-256 checksum
How to use checksums
c1faaaa0b89af4d62e9de4605df8e4e2e87c6afaa440f1a7535594079071c594
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via python-requests/2.25.1

Security for podsearch 0.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page