audios

media

Audio file or recording with title, description, duration, format, playback statistics, and file URL. Used for audio hosting platforms, podcasts, sound libraries, and media management systems.

Request Builder

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

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

Endpoints

GET/audios

Get a collection of audios

Alternative: /media/audios
GET/audios/:id

Get a single audio by ID

Alternative: /media/audios/:id
GET/audios/meta

Get resource metadata and schema

Alternative: /media/audios/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/audios?q=laptop

2. Search Specific Fields

Field-Specific Search
GET https://api.mockly.codes/audios?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 audios
fetch('https://api.mockly.codes/audios?count=10')
  .then(res => res.json())
  .then(data => console.log(data));

Python

Fetch with Requests
import requests

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

cURL

Command Line
curl "https://api.mockly.codes/audios?count=10"

Bypass Cache

Get Fresh Data
fetch('https://api.mockly.codes/audios?nocache=true')

Schema Properties

idinteger

Unique identifier for the audio file

Gen:random_int
titlestring

Title or name of the audio file

Gen:sentence
descriptionstring

Description or summary of the audio content

Gen:paragraph
durationinteger

Audio duration in seconds

Gen:random_int
urlstring

URL or file path to the audio file

Gen:urluri
formatstring

Audio file format (e.g., mp3, wav, ogg, m4a, flac)

Gen:word
playsinteger

Total number of times the audio has been played

Gen:random_int
created_atstring

Timestamp when the audio file was uploaded or created

Gen:past_datedate-time

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