Skip to main content
GET
Get 1 image

Authorizations

API-Key
string
header
required

Query Parameters

fields
enum<string>[]

List of fields to retrieve. Example: fields=title&fields=description

Available options:
image_id,
src,
src_path,
url_img_watermark,
url_img_thumbnail,
title,
headline,
caption,
alt_text,
ai_generated,
model_release,
property_release,
nsfw,
status,
date,
location,
city,
country,
event,
author,
provider,
shot,
scene,
technique,
medium,
keywords,
categories,
collections,
height,
width,
n_faces

Response

Successful Response

image_id
string | null
src
string | null

Url of the image in high or medium resolution (used as source for the AI). Alternative to src_path; provide exactly one of the two.

Example:

"https://cdn.example.com/image/source.jpg"

src_path
string | null

Local filesystem path of the image (used as source for the AI). Alternative to src; provide exactly one of the two.

Example:

"/data/images/source.jpg"

url_img_watermark
string | null

URL of the watermarked image.

Example:

"https://cdn.example.com/image/wm.jpg"

url_img_thumbnail
string | null

URL of the thumbnail image.

Example:

"https://cdn.example.com/image/thumb.jpg"

title
string | null

A shorthand reference for the image.

Example:

"image123"

headline
string | null

Short text describing the image.

Example:

"Sunset over the Hudson River"

caption
string | null

Long text describing the image.

Example:

"A vibrant orange sunset reflecting on the river with the city skyline in silhouette."

alt_text
string | null

Text describing the visual appearance of an image (Accessibility).

ai_generated
boolean | null

Image generated by Artificial Intelligence.

model_release
boolean | null

image with model release.

property_release
boolean | null

image with property release.

nsfw
boolean | null

Image Not Safe For Work.

status
string | null

Current status of the image.

Example:

"Active"

date
string | null

Date of the image creation in year-month-day format. Capture date for photographies.

Example:

"2024-10-19"

location
string | null

A detailed description of the location, complementing the specified country and city with additional details such as street address or notable landmarks.

Example:

"123 Main St, near Central Park"

city
string | null

Name of the country.

Example:

"New York"

country
string | null

Name of the country.

Example:

"United States"

event
string | null

Related event

Example:

"Oscar awards 2024"

author
string | null

The name of the individual or entity responsible for creating the image, such as a photographer or painter.

Example:

"Jane Doe"

provider
string | null

The identifier of the provider, which can be either a unique numeric ID or a descriptive name.

Example:

"Acme Inc."

shot
string | null

Type of photography shot.

Example:

"Portrait"

scene
string | null

Spot, place, visual location

Example:

"Town square"

technique
string | null

The specific method or process used in creating the artwork, reflecting the artist's unique approach or the traditional methods tied to certain mediums.

Example:

"Drawing"

medium
string | null

The material or substance used in the creation of the artwork or object. This field corresponds to various artistic mediums like oils, acrylics, or digital formats.

Example:

"Oil on canvas"

keywords
string[] | null

Specific tags describing the image

Example:
categories
string[] | null

General categories of the image

Example:
collections
string[] | null

Collections that the image belongs to

Example:
height
integer | null

Height of the image.

width
integer | null

Width of the image.

n_faces
integer | null

Num of people faces that appears on the image.