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/image_metadata_updater.phpRequest Methods
Option 1: Request Using Image URL
Method: POST
Body Type: raw: json
Content-Type: application/json
Sample Payload:
Copied!
{
"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
Content-Type: multipart/form-data
Parameters:
| Key | Type | Value |
|---|---|---|
| imagefile | 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 |
Error Codes
Copied!
{
"error": true,
"message":"Invalid image URL or image data."
}