---
title: "Get metadata from remote URL"
method: GET
path: "/v1/metadata"
tags: ["File Metadata"]
---

# Get metadata from remote URL

`GET /v1/metadata`

Get image EXIF, pHash, and other metadata from ImageKit.io powered remote URL using this API.

## Query parameters

- `url` string, uri, required

## Response `200`

File metadata object.

- Metadata — JSON object containing metadata.
  - `height` integer — The height of the image or video in pixels.
  - `width` integer — The width of the image or video in pixels.
  - `size` integer — The file size in bytes.
  - `format` string — The format of the file (e.g., 'jpg', 'mp4').
  - `hasColorProfile` boolean — Indicates if the image has a color profile.
  - `quality` integer — The quality indicator of the image.
  - `density` integer — The density of the image in DPI.
  - `hasTransparency` boolean — Indicates if the image contains transparent areas.
  - `pHash` string — Perceptual hash of the image.
  - `bitRate` integer — The bit rate of the video in kbps (only for video).
  - `duration` integer — The duration of the video in seconds (only for video).
  - `audioCodec` string — The audio codec used in the video (only for video).
  - `videoCodec` string — The video codec used in the video (only for video).
  - `exif` object
    - `image` ExifImage — Object containing EXIF image information.
      - `Make` string
      - `Model` string
      - `ImageDescription` string
      - `Artist` string
      - `Copyright` string
      - `Orientation` integer
      - `XResolution` number
      - `YResolution` number
      - `ResolutionUnit` integer
      - `Software` string
      - `ModifyDate` string
      - `YCbCrPositioning` integer
      - `ExifOffset` integer
      - `GPSInfo` integer
    - `thumbnail` Thumbnail — Object containing Thumbnail information.
      - `Compression` integer
      - `XResolution` number
      - `YResolution` number
      - `ResolutionUnit` integer
      - `ThumbnailOffset` integer
      - `ThumbnailLength` integer
    - `exif` ExifDetails — Object containing Exif details.
      - `ExposureTime` number
      - `FNumber` number
      - `ExposureProgram` integer
      - `ISO` integer
      - `ExifVersion` string
      - `DateTimeOriginal` string
      - `CreateDate` string
      - `ShutterSpeedValue` number
      - `ApertureValue` number
      - `ExposureCompensation` number
      - `MeteringMode` integer
      - `Flash` integer
      - `BrightnessValue` number
      - `MaxApertureValue` number
      - `LightSource` integer
      - `FocalLength` number
      - `UserComment` string
      - `SensingMethod` integer
      - `SceneType` string
      - `FocalLengthIn35mmFormat` integer
      - `LensModel` string
      - `SubSecTime` string
      - `FlashpixVersion` string
      - `ColorSpace` integer
      - `ExifImageWidth` integer
      - `ExifImageHeight` integer
      - `InteropOffset` integer
      - `FocalPlaneXResolution` number
      - `FocalPlaneYResolution` number
      - `FocalPlaneResolutionUnit` integer
      - `CustomRendered` integer
      - `ExposureMode` integer
      - `WhiteBalance` integer
      - `SceneCaptureType` integer
    - `gps` Gps — Object containing GPS information.
      - `GPSVersionID` integer[]
      - `GPSLatitudeRef` string
      - `GPSLatitude` number[]
      - `GPSLongitudeRef` string
      - `GPSLongitude` number[]
      - `GPSAltitudeRef` integer
      - `GPSAltitude` number
      - `GPSTimeStamp` number[]
      - `GPSImgDirectionRef` string
      - `GPSImgDirection` number
      - `GPSDateStamp` string
    - `interoperability` Interoperability — JSON object.
      - `InteropIndex` string
      - `InteropVersion` string
    - `makernote` object

## Other responses

- `400` — Bad request.
- `401` — Unauthorized request.
- `403` — Forbidden.
- `404` — File not found.
- `429` — The request exceeded the rate limit. Contains headers indicating the limits and a message detailing the error.

---

[API](https://skmtc.dev/imagekit-developer/apis/imagekit-api.md) · [All operations](https://skmtc.dev/imagekit-developer/apis/imagekit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/imagekit-developer/imagekit-api/revisions/bb3e9ff84b3e/schema)