// DOCUMENTATION

API REFERENCE

META.X provides a simple, robust HTTP API for programmatically extracting metadata from images. Integrate our extraction engine directly into your applications, scripts, or automated workflows.

NO API KEY REQUIRED

Our API is completely free to use and requires no authentication. To ensure fair usage and maintain service stability, we enforce a rate limit of 100 images per minute per IP address.

POST/api/v1

Extracts EXIF and other metadata from an image file or a remote image URL.

// REQUEST HEADERS

Content-Type: multipart/form-data OR application/json

// REQUEST BODY (FORM-DATA)

Parameter	Type	Description
file	File	The image file to extract metadata from. (Optional if `url` is provided)
url	String	A direct URL to an image. (Optional if `file` is provided)

// REQUEST BODY (JSON)

Parameter	Type	Description
file	String	Base64 encoded string of the image. (Optional if `url` is provided)
url	String	A direct URL to an image. (Optional if `file` is provided)

// EXAMPLE REQUEST (cURL - FORM-DATA)

curl -X POST https://metaex.vercel.app/api/v1 \
  -F "file=@/path/to/your/image.jpg"

// EXAMPLE REQUEST (cURL - JSON)

curl -X POST https://metaex.vercel.app/api/v1 \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/image.jpg"}'

// EXAMPLE RESPONSE (200 OK)

{
  "metadata": {
    "FileName": "image.jpg",
    "FileSize": "2.4 MB",
    "FileType": "JPEG",
    "ImageWidth": 4000,
    "ImageHeight": 3000,
    "Make": "Apple",
    "Model": "iPhone 13 Pro",
    "Software": "15.4.1",
    "ModifyDate": "2023:10:24 14:30:00",
    "GPSLatitude": 37.7749,
    "GPSLongitude": -122.4194
    // ... additional metadata fields
  }
}

// ERROR RESPONSES

400 Bad Request: Missing file or URL parameter.
404 Not Found: No metadata found in the provided image.
429 Too Many Requests: Rate limit exceeded (100 req/min).
500 Internal Server Error: Failed to process the image.