Podcast searcher
Search any podcast in iTunes library
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
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.