Authentication
Parameters:
Output:
Request: https://api.webdamdb.com/api.php?method=login&username=apiusername&password=apipassword Response: <response>
<status>success</status>
<apitoken>fazop73u2lnh2va73ovl83uje5</apitoken>
</response>
|
Output:
Request: https://api.webdamdb.com/api.php?method=logout&api_key=jskwerlo324ls9dk3kdk39szk34ks3ks&apitoken=fazop73u2lnh2va73ovl83uje5 Response: <response>
<status>success</status>
</response>
|
Assets
Parameters:
Output:
Request: https://api.webdamdb.com/api.php?method=getasset&assetid=123 &api_key=jskwerlo324ls9dk3kdk39szk34ks3ks&apitoken=fazop73u2lnh2va73ovl83uje5 Response: <response> <status>success</status> <asset> <id>3437651</id> <status>active</status> <userid>9750</userid> <folderid>90063</folderid> <filename>photo.jpg</filename> <name>photo.jpg</name> <size>146800</size> <width>600</width> <height>800</height> <embededlink>http://url.webdamdb.com/s/zgyXUQi0EV.jpg</embededlink> <expirationdate></expirationdate> <datecreated>1219433101</datecreated> <description></description> </asset> </response> |
Parameters:
Output:
Request: https://api.webdamdb.com/api.php?method=getassetmetadata &assetid=123&type=xmp&api_key=jskwerlo324ls9dk3kdk39szk34ks3ks&apitoken=fazop73u2lnh2va73ovl83uje5 Response: <response>
<status>success</status>
<assetmetadata>
<assetid>123</assetid>
<type>XMP</type>
<fields>
<field>
<code>category</code>
<value>S</value></field>
<field>
<code>credate</code>
<value>2011:02:21 17:38:40-08:00</value>
</field>
<field>
<code>city</code>
<value>New York</value></field>
<field>
<code>state</code>
<value>CA</value></field>
<field>
<code>countryname</code>
<value>USA</value></field>
<field>
<code>headline</code>
<value>Luck</value></field>
<field>
<code>credit</code>
<value>John Smith/Shith Inc</value></field>
<field>
<code>byline</code>
<value>John Smith</value></field>
<field>
<code>caption</code>
<value>First Spring practice on the football practice fields</value>
</field>
</fields>
</assetmetadata>
</response>
|
Parameters:
Output:
Request: Response:
<response>
<status>success</status>
<assets>
<asset>
<id>123</id>
<status>active</status>
<userid>123</userid>
<folderid>90225</folderid>
<filename>1016322088__dsc9916.jpg</filename>
<name>1016322088__dsc9916.jpg</name>
<size>689152</size>
<width>4288</width>
<height>2848</height>
<embededlink>http://url.webdamdb.com/s/EMdYR52Yv8.jpg</embededlink>
<expirationdate></expirationdate>
<datecreated>1219433101</datecreated>
<description>Family laughing in the park</description>
</asset>
<asset>
<id>124</id>
<status>active</status>
<userid>123</userid>
<folderid>90225</folderid>
<filename>1016321196__dsc9913.jpg</filename>
<name>1016321196__dsc9913.jpg</name>
<size>73728</size>
<width>4110</width>
<height>2730</height>
<embededlink>http://url.webdamdb.com/s/vRiwsu2QiY.jpg</embededlink>
<expirationdate></expirationdate>
<datecreated>1219433101</datecreated>
<description>>
</asset>
<asset>
<id>532</id>
<status>active</status>
<userid>32</userid>
<folderid>90225</folderid>
<filename>1016322677__dsc9923.jpg</filename>
<name>1016322677__dsc9923.jpg</name>
<size>549888</size>
<width>3851</width>
<height>2558</height>
<embededlink>http://url.webdamdb.com/s/0vzsSGkNnd.jpg</embededlink>
<expirationdate></expirationdate>
<datecreated>1219433101</datecreated>
<description></description>
</asset>
</assets>
</response>
|
Parameters:
Output:
Request: Response: <response>
<status>success</status>
</response>
|
Parameters:
Output:
Request: Response: <response>
<status>success</status>
</response>
|
Parameters:
Output:
Request: https://api.webdamdb.com/api.php?method=updateassetmetadata Response: <response>
<status>success</status>
</response>
|
Parameters:
Output:
Request: Response: <response>
<status>success</status>
</response>
|
Parameters:
Output:
Request: Response: <response>
<status>success</status>
</response>
|
Parameters:
Output:
Request: https://api.webdamdb.com/api.php?method=downloadasset&assetid=123&api_key=jskwerlo324ls9dk3kdk39szk34ks3ks&apitoken=fazop73u2lnh2va73ovl83uje5 Response: Returns the asset file. |
Parameters:
Output:
Request: <form enctype="multipart/form-data" method="POST"
action="https://api.webdamdb.com/api.php?method=uploadasset&folderid=
123&api_key=jskwerlo324ls9dk3kdk39szk34ks3ks&apitoken=
fazop73u2lnh2va73ovl83uje5">
<input type="file" name="file1">
<input type="submit" value="upload">
</form>
Response: <response>
<status>success</status>
<asset>
<id>3437651</id>
<status>active</status>
<userid>9750</userid>
<folderid>90063</folderid>
<filename>photo.jpg</filename>
<name>photo.jpg</name>
<size>14336</size>
<width>600</width>
<height>800</height>
<embededlink>http://url.webdamdb.com/s/zgyXUQi0EV.jpg</embededlink>
<expirationdate></expirationdate>
<datecreated>1219433101</datecreated>
<description></description>
</asset>
</response>
|
Folders
Parameters:
Output:
Request: Response: <response>
<status>success</status>
<folder>
<id>90063</id>
<name>date</name>
<parent>0</parent>
<userid>9750</userid>
<status>active</status>
<datecreated>1219433101</datecreated>
<description/>
</folder>
</response>
|
Parameters:
Output:
Request: https://api.webdamdb.com/api.php?method=createfolder&name=Buildings&parentid=123&api_key=jskwerlo324ls9dk3kdk39szk34ks3ks&apitoken=fazop73u2lnh2va73ovl83uje5 Response: <response>
<status>success</status>
<folder>
<id>90063</id>
<name>date</name>
<parent>123</parent>
<userid>9750</userid>
<status>active</status>
<datecreated>1219433101</datecreated>
<description/>
</folder>
</response>
|
Parameters:
Output:
Request: https://api.webdamdb.com/api.php?method=movefolder&folderid=123&parentid=432&api_key=jskwerlo324ls9dk3kdk39szk34ks3ks&apitoken=fazop73u2lnh2va73ovl83uje5 Response: <response>
<status>success</status>
</response>
|
Parameters:
Output:
Request: Response: <response>
<status>success</status>
</response>
|
Parameters:
Output:
Request: Response: <response>
<status>success</status>
</response>
|
Search
Parameters:
Output:
Request: https://api.webdamdb.com/api.php?method=search&query=Berkeley&field=All&api_key=jskwerlo324ls9dk3kdk39szk34ks3ks&apitoken=fazop73u2lnh2va73ovl83uje5 Response: <response>
<total>3</total>
<page>1</page>
<perpage>20</perpage>
<assets>
<asset>
<id>123</id>
<status>active</status>
<userid>123</userid>
<folderid>90225</folderid>
<filename>1016322088__dsc9916.jpg</filename>
<name>1016322088__dsc9916.jpg</name>
<size>146800</size>
<width>4288</width>
<height>2848</height>
<embededlink>http://url.webdamdb.com/s/EMdYR52Yv8.jpg</embededlink>
<expirationdate></expirationdate>
<datecreated>1239433101</datecreated>
<description>Family laughing in the park</description>
</asset>
<asset>
<id>124</id>
<status>active</status>
<userid>123</userid>
<folderid>90225</folderid>
<filename>1016321196__dsc9913.jpg</filename>
<name>1016321196__dsc9913.jpg</name>
<size>31600</size>
<width>4110</width>
<height>2730</height>
<embededlink>http://url.webdamdb.com/s/vRiwsu2QiY.jpg</embededlink>
<expirationdate></expirationdate>
<datecreated>1119433101</datecreated>
<description>>
</asset>
<asset>
<id>532</id>
<status>active</status>
<userid>32</userid>
<folderid>90225</folderid>
<filename>1016322677__dsc9923.jpg</filename>
<name>1016322677__dsc9923.jpg</name>
<size>549888</size>
<width>3851</width>
<height>2558</height>
<embededlink>http://url.webdamdb.com/s/0vzsSGkNnd.jpg</embededlink>
<expirationdate></expirationdate>
<datecreated>1219433101</datecreated>
<description></description>
</asset>
</assets>
</response>
|
Reference
| Attribute | Type | Description |
|---|---|---|
| id | long | The unique id of the asset. |
| status | string | The current state of the asset, either active or inactive. |
| userid | long | The user id of the owner of the asset. |
| folderid | long | The id of the folder the asset is located in. |
| filename | string | The filename of the asset. |
| name | string | The name of the asset. |
| size | string | The size of the asset in bytes. |
| width | long | The width in pixels of the asset. The width attribute only applies to certain types of assets such as image or videos. |
| height | long | The height in pixels of the asset. The height attribute only applies to certain types of assets such as image or videos. |
| embededlink | string | The embedable link to the asset preview image. This attribute only applies to certain types of assets such as image or videos |
| expirationdate | string | The unix timestamp of the expiration date of the asset. If this field is empty then no date expiration date is set. |
| datecreated | string | The unix timestamp of the date the asset was created/uploaded. |
| description | string | The description of the asset. This is the same value as the Caption/Abtract XMP/IPTC field. |
| Attribute | Type | Description |
|---|---|---|
| id | long | The unique id of the folder. |
| status | string | The current state of the folder, either active or inactive. |
| userid | long | The user id of the owner of the asset. |
| name | string | The name of the folder. |
| parent | string | The id of the folder the folder is located in. |
| name | string | The name of the folder. |
| datecreated | string | The unix timestamp of the date the folder was created. |
| description | string | The description of the folder. |
| Field | Description |
|---|---|
| artist | Artist |
| bitspersample | Bits Per Sample |
| colorspace | Color Space |
| componentsconfiguration | Components Configuration |
| compressedbitsperpixel | Compressed Bits Per Pixel |
| compression | Compression |
| contrast | Contrast |
| copyright | Copyright |
| customrendered | Custom Rendered |
| datetime | Date Time |
| datetimedigitized | Date Time Digitized |
| datetimeoriginal | Date Time Original |
| digitalzoomratio | Digital Zoom Ratio |
| exifimageheight | Exif Image Length |
| exifimagewidth | Exif Image Width |
| exifoffset | Exif Offset |
| exifversion | Exif Version |
| exposurebiasvalue | Exposure Bias Value |
| exposuremode | Exposure Mode |
| exposureprogram | Exposure Program |
| exposuretime | Exposure Time |
| filesource | File Source |
| flash | Flash |
| flashpixversion | Flashpix Version |
| fnumber | F Number |
| focallength | Focal Length |
| gaincontrol | Gain Control |
| imagedescription | Image Description |
| imagelength | Image Length |
| imageniqueid | Image Unique ID |
| imagewidth | Image Width |
| interoperabilityindex | Interoperability Index |
| interoperabilityoffset | Interoperability Offset |
| interoperabilityversion | Interoperability Version |
| isospeedratings | ISO Speed Ratings |
| jpeginterchangeformat | JPEG Interchange Format |
| jpeginterchangeformatlength | JPEG Interchange Format Length |
| lightsource | Light Source |
| make | Make |
| makernote | Maker Note |
| maxaperturevalue | Max Aperture Value |
| meteringmode | Metering Mode |
| model | Model |
| orientation | Orientation |
| photometricinterpretation | Photometric Interpretation |
| pixelxdimension | Pixel X Dimension |
| pixelydimension | Pixel Y Dimension |
| planarconfiguration | Planar Configuration |
| primarychromaticities | Primary Chromaticities |
| printimagematching | Print Image Matching |
| referenceblackwhite | Reference Black White |
| relatedsoundfile | Related SoundFile |
| resolutionunit | Resolution Unit |
| rowsperstrip | Rows Per Strip |
| samplesperpixel | Samples Per Pixel |
| saturation | Saturation |
| scenecapturetype | Scene Capture Type |
| sharpness | Sharpness |
| software | Software |
| stripbytecounts | Strip Byte Counts |
| stripoffsets | Strip Offsets |
| subsectime | Sub Sec Time |
| subsectimedigitized | Sub Sec Time Digitized |
| subsectimeoriginal | Sub Sec Time Original |
| tainted | Tainted |
| transferfunction | Transfer Function |
| usercomment | User Comment |
| whitebalance | White Balance |
| whitepoint | White Point |
| winxp-author | WinXP-Author |
| winxp-comments | WinXP-Comments |
| winxp-keywords | WinXP-Keywords |
| winxp-subject | WinXP-Subject |
| winxp-title | WinXP-Title |
| xresolution | X Resolution |
| ycbcrcoefficients | YCbCr Coefficients |
| ycbcrpositioning | YCbCr Positioning |
| ycbcrsubsampling | YCbCr SubSampling |
| yresolution | Y Resolution |
| Field | Description |
|---|---|
| byline | By-line |
| bytitle | By-line title |
| caption | Caption/Abstract |
| captionwriter | Writer/Editor |
| category | Category |
| city | City |
| contact | Contact |
| copyright | Copyright notice |
| countrycode | Country/Primary location |
| countryname | Country name |
| creatoradrext | Creator address |
| creatoradrpcode | Creator postal code |
| creatorcity | Creator city |
| creatorcountry | Creator country |
| creatoremailwrk | Creator email |
| creatorregion | Creator state |
| creatortelwrk | Creator phone |
| creatorurlwrk | Creator website |
| credate | Date created |
| credit | Credit |
| cretime | Time created |
| customfield1 | Custom field 1 |
| customfield2 | Custom field 2 |
| customfield3 | Custom field 3 |
| customfield4 | Custom field 4 |
| customfield5 | Custom field 5 |
| customfield6 | Custom field 6 |
| customfield7 | Custom field 7 |
| customfield8 | Custom field 8 |
| customfield9 | Custom field 9 |
| customfield10 | Custom field 10 |
| customfield11 | Custom field 11 |
| customfield12 | Custom field 12 |
| customfield13 | Custom field 13 |
| customfield14 | Custom field 14 |
| customfield15 | Custom field 15 |
| customfield16 | Custom field 16 |
| customfield17 | Custom field 17 |
| customfield18 | Custom field 18 |
| customfield19 | Custom field 19 |
| customfield20 | Custom field 2- |
| datesent | Date sent |
| editstatus | edit status |
| fixture | Fixture identifier |
| headline | Headline |
| imagetype | Image type |
| intelgenre | Intellectual genre |
| isocountrycode | ISO country code |
| keyword | Keywords |
| label | label |
| language | Language identifier |
| marked | Marked |
| objectname | Object name |
| orgprg | Originating program |
| orgtransref | Original transmission reference |
| orientation | Image orientation |
| prgver | Program version |
| rating | Rating |
| reldate | Release date |
| reltime | Release time |
| rightsusageterms | Rights usage terms |
| scene | Scene |
| source | Source |
| specinstr | Special instructions |
| state | Province/State |
| subcategory | Supplemental category |
| subfile | Subfile |
| subjectcode | Subject code |
| sublocation | Sublocation |
| timesent | Time sent |
| urgency | Urgency |
| usageterms | Usage terms |
| webstatement | Copyright info URL |