PHPackages                             listennotes/podcast-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. listennotes/podcast-api

ActiveLibrary[Database & ORM](/categories/database)

listennotes/podcast-api
=======================

PHP bindings for the Listen Notes Podcast API

v1.1.6(2y ago)47.2k↓50%1MITPHPPHP ^7.0 || ^8.0CI passing

Since May 5Pushed 1y ago2 watchersCompare

[ Source](https://github.com/ListenNotes/podcast-api-php)[ Packagist](https://packagist.org/packages/listennotes/podcast-api)[ RSS](/packages/listennotes-podcast-api/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (13)Used By (0)

Podcast API PHP Library
=======================

[](#podcast-api-php-library)

[![PHP CI](https://github.com/ListenNotes/podcast-api-php/actions/workflows/php.yml/badge.svg)](https://github.com/ListenNotes/podcast-api-php/actions/workflows/php.yml) [![Packagist Version](https://camo.githubusercontent.com/69de050a8771b96ad8922187bd56f88a2f0f6b3f804b4864899c12e78250c51c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c697374656e6e6f7465732f706f64636173742d617069)](https://packagist.org/packages/listennotes/podcast-api)

The Podcast API PHP library provides convenient access to the [Listen Notes Podcast API](https://www.listennotes.com/podcast-api/) from applications written in the PHP language.

Simple and no-nonsense podcast search & directory API. Search the meta data of all podcasts and episodes by people, places, or topics. It's the same API that powers [the best podcast search engine Listen Notes](https://www.listennotes.com/).

If you have any questions, please contact [hello@listennotes.com](hello@listennotes.com?subject=Questions+about+the+PHP+SDK+of+Listen+API)

[![](https://raw.githubusercontent.com/ListenNotes/ListenApiDemo/master/web/src/powered_by_listennotes.png)](https://www.listennotes.com/podcast-api/)

**Table of Contents**

- [Podcast API PHP Library](#podcast-api-php-library)
    - [Installation](#installation)
        - [Requirements](#requirements)
    - [Usage](#usage)
        - [Handling exceptions](#handling-exceptions)
    - [API Reference](#api-reference)
        - [Full-text search](#full-text-search)
        - [Typeahead search](#typeahead-search)
        - [Fetch detailed meta data and episodes for a podcast by id](#fetch-detailed-meta-data-and-episodes-for-a-podcast-by-id)
        - [Fetch detailed meta data for an episode by id](#fetch-detailed-meta-data-for-an-episode-by-id)
        - [Fetch a list of supported languages for podcasts](#fetch-a-list-of-supported-languages-for-podcasts)
        - [Fetch a list of podcast genres](#fetch-a-list-of-podcast-genres)
        - [Fetch a list of best podcasts by genre](#fetch-a-list-of-best-podcasts-by-genre)
        - [Fetch a list of supported countries/regions for best podcasts](#fetch-a-list-of-supported-countriesregions-for-best-podcasts)
        - [Fetch recommendations for a podcast](#fetch-recommendations-for-a-podcast)
        - [Fetch recommendations for an episode](#fetch-recommendations-for-an-episode)
        - [Batch fetch basic meta data for episodes](#batch-fetch-basic-meta-data-for-episodes)
        - [Batch fetch basic meta data for podcasts](#batch-fetch-basic-meta-data-for-podcasts)
        - [Fetch a random podcast episode](#fetch-a-random-podcast-episode)
        - [Fetch a curated list of podcasts by id](#fetch-a-curated-list-of-podcasts-by-id)
        - [Fetch curated lists of podcasts](#fetch-curated-lists-of-podcasts)
        - [Submit a podcast to Listen Notes database](#submit-a-podcast-to-listen-notes-database)
        - [Request to delete a podcast](#request-to-delete-a-podcast)
        - [Fetch a playlist's info and items (i.e., episodes or podcasts).](#fetch-a-playlists-info-and-items-ie-episodes-or-podcasts)
        - [Fetch a list of your playlists.](#fetch-a-list-of-your-playlists)
        - [Fetch trending search terms](#fetch-trending-search-terms)
        - [Fetch related search terms](#fetch-related-search-terms)
        - [Spell check on a search term](#spell-check-on-a-search-term)
        - [Fetch audience demographics for a podcast](#fetch-audience-demographics-for-a-podcast)
        - [Fetch podcasts by a publisher's domain name](#fetch-podcasts-by-a-publishers-domain-name)
        - [Find individual episodes by searching for their titles](#find-individual-episodes-by-searching-for-their-titles)

Installation
------------

[](#installation)

Install the official [Composer](http://getcomposer.org/) package of [the Listen Notes Podcast API](https://packagist.org/packages/listennotes/podcast-api):

```
composer require listennotes/podcast-api
```

To use the bindings, use Composer's [autoload](https://getcomposer.org/doc/01-basic-usage.md#autoloading):

```
require_once('vendor/autoload.php');
```

### Requirements

[](#requirements)

- PHP 7.3+

Usage
-----

[](#usage)

The library needs to be configured with your account's API key which is available in your [Listen API Dashboard](https://www.listennotes.com/podcast-api/dashboard/#apps). Set `API_KEY` to its value:

```