▣ DATA EXTRACTION · FILE MANIPULATION

Image Metadata Extractor

What it does

Image Metadata Extractor reads metadata from an image you send by URL or as an uploaded file. Send a publicly accessible image URL to /url/download, or upload an image to /multi-part/download, and get ExifTool-derived metadata back in data.

Use it when you need to inspect image format and file details without opening the file yourself. The response includes fields such as FileType, FileTypeExtension, MIMEType, FileSize, ImageWidth, ImageHeight, ImageSize, BitDepth, ColorType, Compression, Interlace, Megapixels, and timestamps like FileAccessDate and FileModifyDate when available.

The service also returns source and environment details such as FileName, SourceFile, Directory, FilePermissions, and ExifToolVersion. Some images expose additional ExifTool tags too, including ICC profile, GPS, or encoding-related metadata, depending on the source file and format.

Use Image Metadata Extractor for media intake checks, asset cataloging, upload validation, or building workflows that need to classify images by type, size, and encoding before further processing.

▣ ENDPOINT 01 / 02

POST

Extract metadata from image URL (JSON)

https://api.eu.apyverse.com/apyhub/extract-image-metadata/url/download

QUICKSTART

GUIDE

Quickstart

Send the public image URL in a JSON body to extract its metadata.

curl -X POST "https://api.eu.apyverse.com/apyhub/extract-image-metadata/url/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.jpg"}'

What you'll get back

Returns a JSON object with a data object containing image metadata fields such as FileName, FileType, MIMEType, ImageWidth, and ImageHeight. The exact set can vary by image, but it is always wrapped in data.

{
  "data": {
    "FileName": "sample",
    "FileType": "JPEG",
    "MIMEType": "image/jpeg",
    "ImageWidth": 640,
    "ImageHeight": 427
  }
}

TRY ITLIVE · 10 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Downloads an image from the public URL you provide in the request body and returns extracted ExifTool metadata for that image in the data object.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	Publicly accessible image URL. Must be a URI.

Response

Returns a JSON object with a required data object field. data contains image metadata keyed by tag name; the schema explicitly documents the catalog fields below, and additional ExifTool tags may also appear depending on the source image.

Parameter	Type	Mandatory	Description
data	Object	Yes	ExifTool metadata keyed by tag name under `data`. Fields below are the documented catalog attributes; additional ExifTool tags may appear depending on the source image. Field presence varies by file format — not every attribute is returned for every image.
data.Filter	String	No	The filter for the image.
data.BitDepth	Integer	No	The bit depth of the image.
data.FileName	String	No	Base name of the input file (without extension), set by the service.
data.FileSize	String	No	The file size.
data.FileType	String	No	The file type.
data.MIMEType	String	No	The MIME type of the image.
data.ColorType	String	No	The color type of the image.
data.Directory	String	No	The directory for the image (server temp path; not relevant to clients).
data.ImageSize	String	No	The height and width of the image (`WxH`).
data.Interlace	String	No	The interlace mode for the image.
data.ImageWidth	Integer	No	The width of the image in pixels.
data.Megapixels	String	No	Image megapixels (ExifTool may return a string or number).
data.SourceFile	String	No	The source file information (base name set by the service).
data.Compression	String	No	The compression type for the image.
data.ImageHeight	Integer	No	The height of the image in pixels.
data.SRGBRendering	String	No	The sRGB rendering intent for the image.
data.FileAccessDate	String	No	The timestamp when the file was accessed.
data.FileModifyDate	String	No	The timestamp when the file was modified.
data.ExifToolVersion	Number	No	The ExifTool version used to extract metadata.
data.FilePermissions	String	No	The permissions for the file (Linux-style).
data.FileTypeExtension	String	No	The file extension.
data.FileInodeChangeDate	String	No	The timestamp for the inode change date.

Body

Name

Type

Description

bodyREQUIRED

object

Provide `url`.

▣ ENDPOINT 02 / 02

POST

Extract metadata from uploaded image (JSON)

https://api.eu.apyverse.com/apyhub/extract-image-metadata/multi-part/download

QUICKSTART

GUIDE

Quickstart

Upload an image to extract its metadata.

curl -X POST "https://api.eu.apyverse.com/apyhub/extract-image-metadata/multi-part/download" \
  -H "apy-token: $APY_TOKEN" \
  -F "image=@/path/to/image.jpg"

What you'll get back

Returns a JSON object with a data object containing image metadata tags. The data object may include fields such as FileName, FileType, MIMEType, ImageSize, and other ExifTool tag values depending on the uploaded image.

{
  "data": {
    "FileName": "sample",
    "FileType": "JPEG",
    "MIMEType": "image/jpeg",
    "ImageSize": "640x427"
  }
}

TRY ITLIVE · 10 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

About this endpoint

What it does

Uploads an image file and returns JSON metadata extracted from that image. The request sends a binary image file, and the response wraps the extracted metadata in a data object.

Request Body

Parameter	Type	Mandatory	Description
image	String	Yes	Image file to inspect. Binary upload; supported formats include JPEG, PNG, WebP, TIFF, etc.

Response

Returns a JSON object with a required data object field containing ExifTool metadata keyed by tag name. The data object may include the documented attributes below, and additional ExifTool tags may also appear depending on the source image.

Parameter	Type	Mandatory	Description
data	Object	Yes	ExifTool metadata keyed by tag name. Field presence varies by file format; not every attribute is returned for every image. Additional ExifTool tags may appear depending on the source image.
data.Filter	String	No	The filter for the image.
data.BitDepth	Integer	No	The bit depth of the image.
data.FileName	String	No	Base name of the input file, without extension, set by the service.
data.FileSize	String	No	The file size.
data.FileType	String	No	The file type.
data.MIMEType	String	No	The MIME type of the image.
data.ColorType	String	No	The color type of the image.
data.Directory	String	No	The directory for the image. Server temp path; not relevant to clients.
data.ImageSize	String	No	The image size in `WxH` format.
data.Interlace	String	No	The interlace mode for the image.
data.ImageWidth	Integer	No	The width of the image in pixels.
data.Megapixels	Number	No	Image megapixels. The service may return this as a string or a number.
data.SourceFile	String	No	The source file information, with the base name set by the service.
data.Compression	String	No	The compression type for the image.
data.ImageHeight	Integer	No	The height of the image in pixels.
data.SRGBRendering	String	No	The sRGB rendering intent for the image.
data.FileAccessDate	String	No	The timestamp when the file was accessed.
data.FileModifyDate	String	No	The timestamp when the file was modified.
data.ExifToolVersion	Number	No	The ExifTool version used to extract metadata.
data.FilePermissions	String	No	The permissions for the file, in Linux-style format.
data.FileTypeExtension	String	No	The file extension.
data.FileInodeChangeDate	String	No	The timestamp for the inode change date.

Body

Name

Type

Description

bodyREQUIRED

object

—

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.