Podcasts routes

GET/v1/shows/{show}/podcasts

List all podcasts of a show

podcasts.index
Viewer

This list can be filtered. See query params.

Path parameters

Label Description
show (int) id of the show

Query parameters

Label Description
q string to search among podcasts titles
seasons array of season ids. If present, only the podcast belonging to those seasons will be returned. The seasons specified must belong to the show
status array of statuses. A status must be one of those: 'active', 'draft' or 'scheduled'
published_day day of publication (2020-06-15)

Response example

{
    "data": [
        {
            "ai_free_trial_enabled": false,
            "audio_url": "https:\/\/audio.ausha.co\/lo9LTEgLlGYB.mp3",
            "audio_url_internal": "https:\/\/audio.ausha.co\/internal\/lo9LTEgLlGYB.mp3",
            "can_download": true,
            "created_at": "2018-05-02T12:43:08",
            "custom_url": null,
            "description": "Dans cet épisode, du charme, des clébards et des clodos. En quelques minutes la fine équipe tente de vous faire rallumer votre TV pour leur coup de coeur.",
            "downloads_count": 2297,
            "duration": 845.77,
            "files": {
                "data": [
                    {
                        "duration": 0,
                        "format": "original",
                        "key": "sYV6hNYpwEupmkvU01PJz9949TDZ9wg1XJ4twz0L.mp3",
                        "mime_type": "audio\/mpeg",
                        "original_name": "sYV6hNYpwEupmkvU01PJz9949TDZ9wg1XJ4twz0L.mp3",
                        "size": 33834163
                    }
                ]
            },
            "guid": "984b1883a8264fc6e42f862651ac253e53526628",
            "has_custom_slug": false,
            "html_description": "Dans cet épisode, du charme, des clébards et des clodos. En quelques minutes la fine équipe tente de vous faire rallumer votre TV pour leur coup de coeur.",
            "id": 654,
            "image_url": "https:\/\/image.ausha.co\/IylDQD0GT3Pj3zsUWWWNZL60Q78aimJFYu8W67OV_400x400.jpeg",
            "is_explicit": false,
            "name": "​#1 - Bave, Banane et Ballerine",
            "privacy": "public",
            "public_id": "lo9LTEgLlGYB",
            "published_at": "2018-05-02T12:47:45",
            "season_id": 19,
            "show_id": 15,
            "site_url": "https:\/\/podcast.ausha.co\/zap-podcast\/zap-1-bave-banane-et-ballerine",
            "slug": "zap-1-bave-banane-et-ballerine",
            "smartlink_url": "https:\/\/smartlink.ausha.co\/zap-podcast\/zap-1-bave-banane-et-ballerine",
            "soundcloud_publish": null,
            "soundcloud_url": null,
            "state": "active",
            "tags": {
                "data": [
                    {
                        "id": 565,
                        "name": "5fruits&legumes",
                        "slug": "5fruitslegumes"
                    },
                    {
                        "id": 566,
                        "name": "blaguesurlesenfants",
                        "slug": "blaguesurlesenfants"
                    },
                    {
                        "id": 567,
                        "name": "​#metoo",
                        "slug": "metoo"
                    }
                ]
            },
            "type": "full",
            "updated_at": "2024-09-30T13:05:13",
            "use_custom_url": false,
            "waveform_url": "https:\/\/waveform.ausha.co\/sYV6hNYpwEupmkvU01PJz9949TDZ9wg1XJ4twz0L.mp3.dat"
        }
    ],
    "links": {
        "first": "https:\/\/api-content.ausha.co\/v1\/shows\/{show}\/podcasts?per_page=15&page=1",
        "last": "https:\/\/api-content.ausha.co\/v1\/shows\/{show}\/podcasts?per_page=15&page=2",
        "next": "https:\/\/api-content.ausha.co\/v1\/shows\/{show}\/podcasts?per_page=15&page=2",
        "prev": null,
        "self": "https:\/\/api-content.ausha.co\/v1\/shows\/{show}\/podcasts?per_page=15&page=1"
    },
    "meta": {
        "pagination": {
            "count": 15,
            "current_page": 1,
            "per_page": 15,
            "total": 16,
            "total_pages": 2
        }
    }
}

POST/v1/shows/{show}/podcasts

Create a podcast

podcasts.store
Editor

Path parameters

Label Description
show (int) id of the show

Body parameters

Label Description
can_download boolean
custom_url nullable, url
description string, nullable, max:3900
file file, mimetypes:audio/mpeg,audio/x-m4a,audio/x-wav,audio/ogg,audio/x-flac,audio/mp4, video/mp4,application/octet-stream, max_size: Depends on user pricing and mimetype.
html_description string, nullable
is_explicit boolean
name required, string, max:140
privacy string, in:"private","public","unlisted"
published_at date, required_if:state,scheduled
season_id nullable, exists
show_id int, exists
slug nullable, string, alpha_dash, max:255, unique
state string, in:active,blocked,draft,scheduled
tags array, max:20
tags.* string, max:150
type string, in:"bonus","full","trailer"
use_custom_url boolean
youtube_video_title string, nullable, max:100

Response example

{
    "data": {
        "ai_free_trial_enabled": false,
        "audio_url": "https:\/\/audio.ausha.co\/lo9LTEgLlGYB.mp3",
        "audio_url_internal": "https:\/\/audio.ausha.co\/internal\/lo9LTEgLlGYB.mp3",
        "can_download": true,
        "created_at": "2018-05-02T12:43:08",
        "custom_url": null,
        "description": "Dans cet épisode, du charme, des clébards et des clodos. En quelques minutes la fine équipe tente de vous faire rallumer votre TV pour leur coup de coeur.",
        "downloads_count": 2297,
        "duration": 845.77,
        "files": {
            "data": [
                {
                    "duration": 0,
                    "format": "original",
                    "key": "sYV6hNYpwEupmkvU01PJz9949TDZ9wg1XJ4twz0L.mp3",
                    "mime_type": "audio\/mpeg",
                    "original_name": "sYV6hNYpwEupmkvU01PJz9949TDZ9wg1XJ4twz0L.mp3",
                    "size": 33834163
                }
            ]
        },
        "guid": "984b1883a8264fc6e42f862651ac253e53526628",
        "has_custom_slug": false,
        "html_description": "Dans cet épisode, du charme, des clébards et des clodos. En quelques minutes la fine équipe tente de vous faire rallumer votre TV pour leur coup de coeur.",
        "id": 654,
        "image_url": "https:\/\/image.ausha.co\/IylDQD0GT3Pj3zsUWWWNZL60Q78aimJFYu8W67OV_400x400.jpeg",
        "is_explicit": false,
        "name": "​#1 - Bave, Banane et Ballerine",
        "privacy": "public",
        "public_id": "lo9LTEgLlGYB",
        "published_at": "2018-05-02T12:47:45",
        "season_id": 19,
        "show_id": 15,
        "site_url": "https:\/\/podcast.ausha.co\/zap-podcast\/zap-1-bave-banane-et-ballerine",
        "slug": "zap-1-bave-banane-et-ballerine",
        "smartlink_url": "https:\/\/smartlink.ausha.co\/zap-podcast\/zap-1-bave-banane-et-ballerine",
        "soundcloud_publish": null,
        "soundcloud_url": null,
        "state": "active",
        "tags": {
            "data": [
                {
                    "id": 565,
                    "name": "5fruits&legumes",
                    "slug": "5fruitslegumes"
                },
                {
                    "id": 566,
                    "name": "blaguesurlesenfants",
                    "slug": "blaguesurlesenfants"
                },
                {
                    "id": 567,
                    "name": "​#metoo",
                    "slug": "metoo"
                }
            ]
        },
        "type": "full",
        "updated_at": "2024-09-30T13:05:13",
        "use_custom_url": false,
        "waveform_url": "https:\/\/waveform.ausha.co\/sYV6hNYpwEupmkvU01PJz9949TDZ9wg1XJ4twz0L.mp3.dat"
    }
}

GET/v1/podcasts/{podcast}

Podcasts show

podcasts.show
Viewer

GET/v1/podcasts/public_id/{podcastByPublicId}

Get a podcast by public id

podcasts.show.by_publicid
Viewer

Path parameters

Label Description
podcastByPublicId (string) public id of the podcast

PUT/v1/podcasts/{podcast}

Podcasts update

podcasts.update
Editor

DELETE/v1/podcasts/{podcast}

Podcasts destroy

podcasts.destroy
Admin

POST/v1/podcasts/{podcast}/image

Add an image to a podcast

podcasts.image.store
Editor

Warning : if any, previous image will be replaced.

Path parameters

Label Description
podcast (int) id of the podcast

Body parameters

Label Description
file required, image, max:10000, dimensions:min_width=400,min_height=400

Response example

{
    "data": {
        "format": "original",
        "url": "https:\/\/image.ausha.co\/C4NrxrBA5XFxFBIfZxsdK2VNqz1fQ4R2k5iOqFk2.jpeg"
    }
}

POST/v1/podcasts/{podcast}/file

Add an audio file to a podcast

podcasts.file.store
Editor

Warning : if any, previous file will be replaced.

Path parameters

Label Description
podcast (int) id of the podcast

Body parameters

Label Description
file required, file, mimetypes:audio/mpeg,audio/x-m4a,audio/x-wav,audio/ogg, audio/x-flac,audio/mp4,video/mp4,application/octet-stream, max_size: Depends on user pricing and mimetype.

Response example

{
    "data": {
        "ai_free_trial_enabled": false,
        "audio_url": "https:\/\/audio.ausha.co\/lo9LTEgLlGYB.mp3",
        "audio_url_internal": "https:\/\/audio.ausha.co\/internal\/lo9LTEgLlGYB.mp3",
        "can_download": true,
        "created_at": "2018-05-02T12:43:08",
        "custom_url": null,
        "description": "Dans cet épisode, du charme, des clébards et des clodos. En quelques minutes la fine équipe tente de vous faire rallumer votre TV pour leur coup de coeur.",
        "downloads_count": 2297,
        "duration": 845.77,
        "files": {
            "data": [
                {
                    "duration": 0,
                    "format": "original",
                    "key": "sYV6hNYpwEupmkvU01PJz9949TDZ9wg1XJ4twz0L.mp3",
                    "mime_type": "audio\/mpeg",
                    "original_name": "sYV6hNYpwEupmkvU01PJz9949TDZ9wg1XJ4twz0L.mp3",
                    "size": 33834163
                }
            ]
        },
        "guid": "984b1883a8264fc6e42f862651ac253e53526628",
        "has_custom_slug": false,
        "html_description": "Dans cet épisode, du charme, des clébards et des clodos. En quelques minutes la fine équipe tente de vous faire rallumer votre TV pour leur coup de coeur.",
        "id": 654,
        "image_url": "https:\/\/image.ausha.co\/IylDQD0GT3Pj3zsUWWWNZL60Q78aimJFYu8W67OV_400x400.jpeg",
        "is_explicit": false,
        "name": "​#1 - Bave, Banane et Ballerine",
        "privacy": "public",
        "public_id": "lo9LTEgLlGYB",
        "published_at": "2018-05-02T12:47:45",
        "season_id": 19,
        "show_id": 15,
        "site_url": "https:\/\/podcast.ausha.co\/zap-podcast\/zap-1-bave-banane-et-ballerine",
        "slug": "zap-1-bave-banane-et-ballerine",
        "smartlink_url": "https:\/\/smartlink.ausha.co\/zap-podcast\/zap-1-bave-banane-et-ballerine",
        "soundcloud_publish": null,
        "soundcloud_url": null,
        "state": "active",
        "tags": {
            "data": [
                {
                    "id": 565,
                    "name": "5fruits&legumes",
                    "slug": "5fruitslegumes"
                },
                {
                    "id": 566,
                    "name": "blaguesurlesenfants",
                    "slug": "blaguesurlesenfants"
                },
                {
                    "id": 567,
                    "name": "​#metoo",
                    "slug": "metoo"
                }
            ]
        },
        "type": "full",
        "updated_at": "2024-09-30T13:05:13",
        "use_custom_url": false,
        "waveform_url": "https:\/\/waveform.ausha.co\/sYV6hNYpwEupmkvU01PJz9949TDZ9wg1XJ4twz0L.mp3.dat"
    }
}