About
Easily write, resize, and enrich your images with standardized metadata using this powerful RESTful API. This API supports syncing metadata across XMP, IPTC, EXIF, and more.
API Documentation
Copied!
https://imagemetapro.com/tools/v1/image-metadata-updater.php Request Methods
Option 1: Request Using Image URL
Method: POST
Body Type: raw: json
Headers: Content-Type: application/json
Sample Payload:
Copied!
{
"api_key" : "{{API Key}}",
"image_url": "your-image-url",
"return": "url",
"sync_metadata": true,
"resize": true,
"dimensions": "1020X1025",
"convert_format": false,
"new_format": "webp",
"title": "test_xmp_title",
"description": "test_xmp_caption",
"creator": "test_xmp_author",
"copyright_notice": "test_xmp_copyright_notice - do not copy this image without author permission",
"copyright_status": "False",
"keywords": "test_xmp_keywords",
"create_date": "2025-02-23T15:30:00Z",
"category": "Sports",
"supplemental_category": "test_xmp_niche_category",
"caption_writer": "test_xmp_desc_writer",
"city": "test_xmp_city",
"region": "test_xmp_state",
"country": "test_xmp_country_code",
"credit": "test_xmp_credit - John Doe Photography",
"source": "test_xmp_source - test_user",
"headline": "test_xmp_headline - theme selection text",
"instructions": "test_idp_xmp_instructions",
"transmission_reference": "test_xmp_transmission_reference",
"job_reference": "test_xmp_job_name",
"rating": "5",
"label": "Red",
"creator_tool": "Adobe Photoshop 2024",
"usage_terms": "Allowed for educational purposes only",
"creator_contact_address": "John Doe, johndoe@example.com",
"creator_contact_email": "test_xmp_contact@johndoe.com",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution_name": "Jane Doe",
"attribution_url": "https://janedoephotography.com",
"alt_text": "test_xmp_alt_text",
"licensor_name": "test_xmp_doe_agency",
"licensor_url": "https://doeagency.com",
"identifier": "test_xmp_image_12345",
"latitude": "29.7604",
"latitude_ref": "N",
"longitude": "95.3698",
"longitude_ref": "W",
"urgency": "5",
"file_comment": "Metadata updated by API"
}
Option 2: Request Using Local Image Upload
Method: POST
Body Type: form-data
Headers: Content-Type: multipart/form-data
Parameters:
| Key | Type | Value |
|---|---|---|
| api_key | text | {{API Key}} |
| image | file | Select image from your local storage |
| return | text | url |
| sync_metadata | text | true |
| resize | text | true |
| dimensions | text | 1020X1025 |
| convert_format | text | false |
| new_format | text | webp |
| title | text | test_xmp_title |
| description | text | test_xmp_caption |
| creator | text | test_xmp_author |
| copyright_notice | text | test_xmp_copyright_notice - do not copy this image without author permission |
| copyright_status | text | False |
| keywords | text | test_xmp_keywords |
| create_date | text | 2025-02-23T15:30:00Z |
| category | text | Sports |
| supplemental_category | text | test_xmp_niche_category |
| caption_writer | text | test_xmp_desc_writer |
| city | text | test_xmp_city |
| region | text | test_xmp_state |
| country | text | test_xmp_country_code |
| credit | text | test_xmp_credit - John Doe Photography |
| source | text | test_xmp_source - test_user |
| headline | text | test_xmp_headline - theme selection text |
| instructions | text | test_idp_xmp_instructions |
| transmission_reference | text | test_xmp_transmission_reference |
| job_reference | text | test_xmp_job_name |
| rating | text | 5 |
| label | text | Red |
| creator_tool | text | Adobe Photoshop 2024 |
| usage_terms | text | Allowed for educational purposes only |
| creator_contact_address | text | John Doe, johndoe@example.com |
| creator_contact_email | text | test_xmp_contact@johndoe.com |
| license | text | https://creativecommons.org/licenses/by/4.0/ |
| attribution_name | text | Jane Doe |
| attribution_url | text | https://janedoephotography.com |
| alt_text | text | test_xmp_alt_text |
| licensor_name | text | test_xmp_doe_agency |
| licensor_url | text | https://doeagency.com |
| identifier | text | test_xmp_image_12345 |
| latitude | text | 29.7604 |
| latitude_ref | text | N |
| longitude | text | 95.3698 |
| longitude_ref | text | W |
| urgency | text | 5 |
| file_comment | text | Metadata updated by API |
Note: Replace {{API Key}} with your actual API key from your dashboard.
Error Codes
Copied!
{
"success": false,
"message": "Invalid image URL or image data."
}