▣ DATA EXTRACTION · FILE MANIPULATION

Extract Image Metadata API

Hosted on ApyHub

What it does

Image Metadata Extractor reads an image and returns the metadata ExifTool can detect for that file. Send either an uploaded image binary or a publicly accessible image URL, and get a JSON response under data with fields such as FileType, MIMEType, ImageWidth, ImageHeight, ImageSize, ColorType, BitDepth, Compression, FileSize, FileName, and ExifToolVersion when available.

Use it when you need to inspect image properties before storing, processing, or serving assets. It can help you check dimensions for layout rules, confirm format and MIME type before upload, or read file-level details during media ingestion and QA. The service supports common image formats including JPEG, PNG, WebP, and TIFF.

The response is a metadata object keyed by tag name, so the exact fields can vary by source image and file format. In addition to the documented attributes, other ExifTool tags may appear depending on the image, including ICC profile, GPS, and encoding-related details.

If you are building an asset pipeline, CMS, moderation workflow, or analytics tool, Image Metadata Extractor gives you structured image metadata without having to parse files yourself.

▣ ENDPOINT 01 / 02

POST

input file

http://localhost:8080/apyhub/extract-image-metadata/multi-part/download

QUICKSTARTGUIDE

Quickstart

Upload an image file to extract its metadata.

curl -X POST "http://localhost:8080/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 keyed by ExifTool tag name. The documented fields include items like FileType, MIMEType, ImageWidth, and ImageHeight; additional ExifTool tags may also appear depending on the file.

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

TRY ITLIVE · 30 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 extracted ExifTool metadata as JSON. The request body must include an image binary file, and the response wraps the metadata under a data object.

Request Body

Parameter	Type	Mandatory	Description
image	String	Yes	Image file to inspect. Accepted examples include JPEG, PNG, WebP, TIFF, etc. The value is sent as binary file content.

Response

Returns a JSON object with a required data object field. data contains ExifTool metadata keyed by tag name; the schema documents a set of common image attributes, 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. The documented fields below may be present depending on the image format, and additional tags can also appear.
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. This is a server temp path and is not relevant to clients.
data.ImageSize	String	No	The image dimensions 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	String	No	Image megapixels. ExifTool may return this value as either 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 file permissions 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.

▣ ENDPOINT 02 / 02

POST

input url

http://localhost:8080/apyhub/extract-image-metadata/url/download

QUICKSTARTGUIDE

Quickstart

Send a public image URL to extract its metadata.

curl -X POST "http://localhost:8080/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 data object may include additional ExifTool tags depending on the image.

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

TRY ITLIVE · 30 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 the image at the provided public URL and returns extracted ExifTool metadata as JSON. The request body supplies the image URL, and the response wraps the metadata fields under data.

Request Body

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

Response

Returns a JSON object with a data object field containing ExifTool metadata keyed by tag name. The documented response fields include file, image, and extraction attributes such as FileName, FileType, MIMEType, ImageWidth, and ImageHeight; 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`. Documented fields are listed below; additional tags may appear depending on the image format and source file.
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`.

▣ 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.