Utilities

Resources

📝

podcasts

Podcast episode with audio content, metadata, host information, episode details, and engagement metrics. Used for podcast platforms and audio content management.

🎯 Request Builder

Endpoint Type

Count (1-100)

Skip Cache

Request URL

https://api.mockly.codes/podcasts?page=1&limit=10&count=10

📡

Configure your request and click Send Request to see the response here.

Endpoints

GET/podcasts

Get a collection of podcasts

Alternative: /content/podcasts

GET/podcasts/:id

Get a single podcast by ID

Alternative: /content/podcasts/:id

GET/podcasts/meta

Get resource metadata and schema

Alternative: /content/podcasts/meta

🔍

How to Use Search

The search feature allows you to filter results by searching for text across all or specific fields. Choose between ?q= or ?search= parameter names.

1. Basic Search

Search across all text fields:

Basic Search

GET https://api.mockly.codes/podcasts?q=laptop

2. Search Specific Fields

Field-Specific Search

GET https://api.mockly.codes/podcasts?q=laptop&search_fields=name,description

💡 Pro Tips

•Search is case-insensitive and performs partial matching
•Without search_fields, all text fields are searched
•Combine with pagination to handle large result sets efficiently

Code Examples

JavaScript

Fetch Collection

// Get 10 podcasts
fetch('https://api.mockly.codes/podcasts?count=10')
  .then(res => res.json())
  .then(data => console.log(data));

Python

Fetch with Requests

import requests

response = requests.get(
    'https://api.mockly.codes/podcasts?count=10'
)
data = response.json()

cURL

Command Line

curl "https://api.mockly.codes/podcasts?count=10"

Bypass Cache

Get Fresh Data

fetch('https://api.mockly.codes/podcasts?nocache=true')

Schema Properties

idinteger

Unique identifier for the podcast episode

Gen:random_int

titlestring

Title of the podcast episode

Gen:sentence

descriptionstring

Episode description or show notes

Gen:paragraph

hoststring

Full name of the podcast host or hosts

Gen:name

categorystring

Podcast category or genre (e.g., Technology, Business, Comedy, True Crime)

Gen:podcast_category

episode_numberinteger

Episode number in the podcast series

Gen:random_int

seasoninteger

Season number if the podcast has seasons

Gen:random_int

durationinteger

Episode duration in minutes

Gen:podcast_duration

release_datestring

Date when the episode was released

Gen:past_datedate

playsinteger

Total number of times the episode has been played or streamed

Gen:random_int

ratingnumber

Average listener rating, typically on a scale of 1-5

Gen:rating

languagestring

Language code of the podcast content (e.g., en, es, fr)

Gen:language

audio_urlstring

URL to the audio file or streaming link for the episode

Gen:urluri

coverstring

URL to the episode cover art or thumbnail image

Gen:image_urluri

Query Parameters

countinteger

Number of items to return (default: 10, max: 100)

seedinteger

Seed for reproducible data generation

nocacheboolean

Bypass cache and generate fresh data on every request