Libsyn API Reference

User-Shows

Handles retrieving user shows for the developer account.

Fields

Field Type Description
show_id integer Represents a valid Libsyn show ID (numeric or string) (may also be known as show slug).
user_id integer Represents the user id associated with the developer account.
show_slug string Show slug of the retrieved show.
show_title string Show title of the retrieved show.
show_description string Show description of the retrieved show.
is_live boolean Specifies if the retrieved show is active.
in_directory boolean Specifies if the retrieved show is in the Libsyn directory.
image_content_id integer Represents the image content id of the show artwork of the retrieved show.
image_url string Image URL of the show artwork of the retrieved show.
storage object User-show storage quota and usage.
copyright string Copyright of the retrieved show.
website_url string Website url of the retrieved show.
contact_email string Contact email of the retrieved show.
apple_podcasts_store_url string Apple podcasts store url of the retrieved show.
apple_podcasts_store_id integer Apple podcasts store id of the retrieved show.
num_posts integer Total number of posts published on the retrieved show.
is_premium boolean Specifies if the retrieved show is premium.

Request
Headers
Header Value
Accept application/json
Content-Type multipart/form-data

Search User Shows

Retrieve a list of all user shows for the developer account.

Request

Send a GET request to the /user-shows endpoint

$ curl https://api.libsyn.com/user-shows

-X GET \

-H 'Authorization:Bearer (Your Access Token)'

-H 'Accept: application/json'

-H 'Content-Type: multipart/form-data'


Response

On success, your app will receive the following response:


{
	"_links": {
		"self": {
			"href": "/user-shows"
		}
	},
	"_embedded": {
		"user-shows": [
			{
				"show_id": "(int) - Represents a valid Libsyn show ID (numeric or string) (may also be known as show slug)."
				"user_id": "(int) - Represents the user id associated with the developer account."
				"show_slug": "(string) - Show slug of the retrieved show."
				"show_title": "(string) - Show title of the retrieved show."
				"show_description": "(string) - Show description of the retrieved show."
				"is_live": "(boolean) - Specifies if the retrieved show is active."
				"in_directory": "(boolean) - Specifies if the retrieved show is in the Libsyn directory."
				"image_content_id": "(int) - Represents the image content id of the show artwork of the retrieved show."
				"image_url": "(string) - Image URL of the show artwork of the retrieved show."
				"storage": "(string) - User-show storage quota and usage."
				"copyright": "(string) - 	Copyright of the retrieved show."
				"website_url": "(string) - Website url of the retrieved show."
				"contact_email": "(string) - Contact email of the retrieved show."
				"apple_podcasts_store_url": "(string) - Apple podcasts store url of the retrieved show."
				"apple_podcasts_store_id": "(int) - Apple podcasts store id of the retrieved show."
				"is_premium": "(boolean) - 	Specifies if the retrieved show is premium."
			}
	  ]
	},
	"total_items": "(int)	- The total number of items returned in the search request."
}
Retrieve User Show

Retrieves information on an individual Libsyn user-show.

Request

Send a GET request to the /user-shows/[:show_id] endpoint:

$ curl https://api.libsyn.com/user-shows/[:show_id]

-X GET \

-H 'Authorization:Bearer (Your Access Token)'

-H 'Accept: application/json'

-H 'Content-Type: multipart/form-data'


Response

On success, your app will receive the following response:


{
	"_links": {
		"self": {
			"href": "/user-shows/[:show_id]"
		},
	}
	 "_embedded": {
		"user-shows": {
			"show_id": "(int) - Represents a valid Libsyn show ID (numeric or string) (may also be known as show slug)."
			"user_id": "(int) - Represents the user id associated with the developer account."
			"show_slug": "(string) - Show slug of the retrieved show."
			"show_title": "(string) - Show title of the retrieved show."
			"show_description": "(string) - Show description of the retrieved show."
			"is_live": "(boolean) - Specifies if the retrieved show is active."
			"in_directory": "(boolean) - Specifies if the retrieved show is in the Libsyn directory."
			"image_content_id": "(int) - Represents the image content id of the show artwork of the retrieved show."
			"image_url": "(string) - Image URL of the show artwork of the retrieved show."
			"storage": "(string) - User-show storage quota and usage."
			"copyright": "(string) - 	Copyright of the retrieved show."
			"website_url": "(string) - Website url of the retrieved show."
			"contact_email": "(string) - Contact email of the retrieved show."
			"apple_podcasts_store_url": "(string) - Apple podcasts store url of the retrieved show."
			"apple_podcasts_store_id": "(int) - Apple podcasts store id of the retrieved show."
			"num_posts": "(int) - 	Total number of posts published on the retrieved show."
			"is_premium": "(boolean) - 	Specifies if the retrieved show is premium."
		}
	}
	"total_items": "(int)	- The total number of items returned in the search request."
}