images

media

Image file with metadata including dimensions, file size, format, photographer, location, tags, and URLs. Used for image hosting platforms, photo galleries, stock photo sites, and media libraries.

Request Builder

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

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

Endpoints

GET/images

Get a collection of images

Alternative: /media/images
GET/images/:id

Get a single image by ID

Alternative: /media/images/:id
GET/images/meta

Get resource metadata and schema

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

2. Search Specific Fields

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

Python

Fetch with Requests
import requests

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

cURL

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

Bypass Cache

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

Schema Properties

idinteger

Unique identifier for the image

Gen:random_int
titlestring

Title or caption of the image

Gen:sentence
descriptionstring

Brief description of the image content

Gen:sentence
urlstring

URL to the full-size image file

Gen:image_urluri
thumbnail_urlstring

URL to a smaller thumbnail version of the image

Gen:image_urluri
widthinteger

Image width in pixels

Gen:image_width
heightinteger

Image height in pixels

Gen:image_height
sizeinteger

File size in bytes

Gen:file_size
formatstring

Image file format (e.g., jpg, png, gif, webp, svg)

Gen:image_format
tagsarray

Array of tags for categorization and search

Gen:tags
photographerstring

Full name of the photographer who took the image

Gen:name
locationstring

Location where the image was taken

Gen:city
uploaded_atstring

Timestamp when the image was uploaded

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