The Open Web Images API response includes up to 10 ImageDocs and a Meta Info area with reference to API consumption and the request itself, such as the "next" URL to get the next batch of images matching your query.
Each ImageDoc is constructed of 4 objects:
- The ImageDoc Object - also referred to as common and includes all common metadata fields.
- The XMP object - includes XMP protocol information.
- The IPTC object - includes IPTC protocol information.
- The EXIF object - includes EXIF protocol information.
ImageDoc Object
| Field Name | Description | Searchable? | Type |
|---|---|---|---|
| uuid | A unique ID representing the thread | True | String |
| label | The objects identified in the image Please refer to Image Labels for a list of common labels | Yes | Array[String] |
| width | The image width in pixels | Yes | Integer |
| height | The image height in pixels | Yes | Integer |
| description | The image textual information | Yes | String |
| creation_date | The date/time when the image was created | Yes | The Unix epoch time in milliseconds. |
| modify_date | The date/time when the image was last modified | Yes | The Unix epoch time in milliseconds |
| bits_pixel | The number of bits compressed per pixel | Yes | Integer |
| compression | The image compression algorithm used | Yes | String |
| mime_type | The image format (e.g. jpeg, png, etc.) | Yes | String |
| endianness | The type of bit order in the image content, could be None | Big Indian | Little Indian | Yes | String |
| gps_info | The location where the image was taken format is [lat,long] | No | Geo Point |
| artist | The image owner | Yes | String |
| copyright | The copyright model of the image | Yes | String |
| crawled | The date/time when the post with the ImageDoc was collected | Yes | The Unix epoch time in milliseconds |
IPTC Object
| Field Name | Description | Searchable? | Type |
|---|---|---|---|
| object_name | Artwork or Object in the Image | Yes | String |
| city | Name of the city of origin | Yes | String |
| country | The ISO code of a country of a origin | Yes | String |
| category | The mapped category that matches the image For more information, see: IPTC Category | Yes | String |
XMP Object
| Field Name | Description | Searchable? | Type |
|---|---|---|---|
| source | The source of the Image: It may be Owner or Artist | Yes | String |
| keywords | A list of keywords that describe the image | Yes | Array [String] |
EXIF Object
Here is a list of EXIF specific fields:
| EXIF Field | Field Type |
|---|---|
| camera_serial_number | String |
| subject_location | Array [Integer] |
| image_resources | String |
| camera_serial_number | String |
| image_id | String |
| lens_serial_number | String |
| lens_model | String |
| lens_specification | String |
| body_serial_number | String |
| camera_owner_name | String |
| image_unique_id | String |
| subject_distanceRange | Integer |
| device_setting_description | String |
| sharpness | Integer |
| saturation | Integer |
| contrast | Integer |
| gainControl | Integer |
| scene_capture_type | Integer |
| focal_length_in_35mm_film | Integer |
| exposure_mode | Integer |
| custom_rendered | Integer |
| scene_type | String |
| file_source | String |
| sensing_method | Integer |
| exposure_index | Integer |
| subject_location | list Integer |
| user_comment | String |
| security_classification | String |
| image_number | String |
| noise | Integer |
| flash | Integer |
| light_source | Integer |
| brightness_value | Integer |
| aperture_value | Array [Integer] |
| shutter_speed_value | Array [Integer] |
| date_time_digitized | String |
| date_time_original | String |
| self_timer_mode | Integer |
| time_zone_offset | Integer |
| iso_speed_ratings | Integer |
| spectral_sensitivity | Integer |
| exposure_program | String |
| exposure_time | Array [Integer] |
| host_computer | String |
| software | String |
| resolution_unit | String |
| page_name | String |
| y_resolution | Array [Integer] |
| x_resolution | Array [Integer] |
| model | String |
| make | String |
| document_name | String |
{
uuid: "265537117101510550776745780674959141702",
label: null,
width: 640,
height: 480,
description: "",
creation_date: "2008-11-01T21:15:07.000+02:00",
modify_date: null,
bits_pixel: null,
compression: null,
mime_type: "JPEG",
endianness: null,
gps_info: [
43.46715666666389,
11.885394999997223
],
artist: null,
copyright: null,
iptc: {
object_name: null,
city: null,
province_state: null,
country: null,
category: null
},
xmp: {
source: null,
keywords: null
},
exif: {
camera_serial_number: null,
subject_location: null,
image_resources: null,
image_id: null,
lens_serial_number: null,
lens_model: null,
lens_specification: null,
body_serial_number: null,
camera_owner_name: null,
image_unique_id: null,
subject_distance_range: null,
device_setting_description: null,
sharpness: 0,
saturation: 0,
contrast: 0,
gain_control: null,
scene_capture_type: 0,
focal_length_in_35mm_film: 28,
xposure_mode: 0,
custom_rendered: 0,
scene_type: "01",
file_source: "03",
sensing_method: null,
exposure_index: null,
user_comment: "ASCII",
security_classification: null,
image_number: null,
noise: null,
flash: 16,
light_source: 0,
brightness_value: null,
aperture_value: null,
shutter_speed_value: null,
date_time_digitized: "2008:10:22 16:29:49",
date_time_original: "2008:10:22 16:29:49",
self_timer_mode: null,
time_zone_offset: null,
iso_speed_ratings: 64,
spectral_sensitivity: null,
exposure_program: null,
exposure_time: [
560852,
100000000
],
host_computer: null,
software: "Nikon Transfer 1.1 W",
resolution_unit: "Inch",
page_name: null,
y_resolution: [
300,
1
],
x_resolution: [
300,
1
],
model: "COOLPIX P6000",
make: "NIKON",
document_name: null
},
}
Meta Info
| Field Name | Description | Type |
|---|---|---|
| totalResults | The total number of ImageDocs matching your query | Integer |
| moreResultsAvailable | How many more results are available | Integer |
| next | A URL to get the next batch of images matching your query. See Pagination and Sorting in this section. | String |
| requestsLeft | How many more requests are available in your current subscription plan | Integer |