Get image metadata from remote URL
getGet image metadata from remove URL API
get
https://api.imagekit.io/v1/metadata
Get image EXIF, pHash, and other metadata from ImageKit.io powered remote URL using this API.
Request
Response
Request
Headers
Authorization
required
string
base64 encoding of
your_private_api_key:
Note the colon in the end.Query Parameters
url
required
string
The encoded URL of the image.
Note: This URL should be accessible using your ImageKit.io account.
Response
200: OK
On success, you will receive the image metadata in JSON-encoded response body.
{"height": 68,"width": 100,"size": 7749,"format": "jpg","hasColorProfile": true,"quality": 0,"density": 72,"hasTransparency": false,"pHash": "f06830ca9f1e3e90","exif": {"image": {"Make": "Canon","Model": "Canon EOS 40D","Orientation": 1,"XResolution": 72,"YResolution": 72,"ResolutionUnit": 2,"Software": "GIMP 2.4.5","ModifyDate": "2008:07:31 10:38:11","YCbCrPositioning": 2,"ExifOffset": 214,"GPSInfo": 978},"thumbnail": {"Compression": 6,"XResolution": 72,"YResolution": 72,"ResolutionUnit": 2,"ThumbnailOffset": 1090,"ThumbnailLength": 1378},"exif": {"ExposureTime": 0.00625,"FNumber": 7.1,"ExposureProgram": 1,"ISO": 100,"ExifVersion": "0221","DateTimeOriginal": "2008:05:30 15:56:01","CreateDate": "2008:05:30 15:56:01","ShutterSpeedValue": 7.375,"ApertureValue": 5.625,"ExposureCompensation": 0,"MeteringMode": 5,"Flash": 9,"FocalLength": 135,"SubSecTime": "00","SubSecTimeOriginal": "00","SubSecTimeDigitized": "00","FlashpixVersion": "0100","ColorSpace": 1,"ExifImageWidth": 100,"ExifImageHeight": 68,"InteropOffset": 948,"FocalPlaneXResolution": 4438.356164383562,"FocalPlaneYResolution": 4445.969125214408,"FocalPlaneResolutionUnit": 2,"CustomRendered": 0,"ExposureMode": 1,"WhiteBalance": 0,"SceneCaptureType": 0},"gps": {"GPSVersionID": [2,2,0,0]},"interoperability": {"InteropIndex": "R98","InteropVersion": "0100"},"makernote": {}}}
In case of error, you will get an error code along with the error message. On success, you will receive a 200 status code with the image metadata in the JSON-encoded response body.
A metadata object example can be found here.
If the url passed to this API has no transformation parameter, then the metadata of the original uploaded image will be fetched. We internally add orig-true parameter to fetch the original image.
Instead, if the passed url has any transformation parameters, then the metadata of the transformed image will be fetched.
See the examples below.
Here are some example requests to understand the API usage.
cURL
Python
PHP
Java
Ruby
cURL
# The unique fileId of the uploaded file. fileId is returned in response of list files API and upload API.curl -X GET "https://api.imagekit.io/v1/metadata?url=https://ik.imagekit.io/demo/default-image.jpg" \-u your_private_api_key:
Python
imagekit.get_remote_file_url_metadata("remote_file_url")
PHP
$imageKit->getFileMetadataFromRemoteURL("remote_file_url")
Java
ResultMetaData result=ImageKit.getInstance().getRemoteFileMetadata("remote_file_url");
Ruby
imagekitio = ImageKit::ImageKitClient.new("your_private_key", "your_public_key", "your_url_endpoint")imagekitio.get_remote_file_url_metadata("remote_file_url")
cURL
Python
PHP
Java
Ruby
cURL
# The URL of the uploaded filecurl -X GET "https://api.imagekit.io/v1/metadata?url=https://ik.imagekit.io/demo/tr:w-100/default-image.jpg" \-u your_private_api_key:
Python
imagekit.get_remote_file_url_metadata("https://ik.imagekit.io/demo/tr:w-100/default-image.jpg")
PHP
$imageKit->getFileMetadataFromRemoteURL("https://ik.imagekit.io/demo/tr:w-100/default-image.jpg")
Java
ResultMetaData result=ImageKit.getInstance().getRemoteFileMetadata("https://ik.imagekit.io/demo/tr:w-100/default-image.jpg");
Ruby
imagekitio.get_remote_file_url_metadata("https://ik.imagekit.io/demo/tr:w-100/default-image.jpg")
See examples here.
Last updated 6 months ago