DEPRECATED Media search API specification

Originally posted 4 Feb 2010 by eightysteele:

Overview

Arctos will expose media records in the database through a data API that will accept HTTP GET requests to query media and return matching records as a JSON string. The API will support pagination.

API

Parameters The API accepts the following parameters:

Parameter Description Example q The query string Woodpecker p The result page size 20 b The page bookmark (media record id) 30049 t The media type (image, video, audio, document) audio,image

Example

Search all audio and image media for woodpecker starting with media id 30049 and return 20 results:

http://arctos.com/services/media?q=woodpecker&p=20&b=30049&t=audio,image

JSON Results

Media results are returned as a JSON string:

[ { "id": "30049", # Media ID "type": "image", # Media Type "institution": "MVZ", # Institution Code "collection": "Bird", # Collection Code "catalog": 123, # Catalog Number "taxonomy" : "Heron", # Scientific Name "creator" : "Carla Cicero", # Creator of media "location": "California, Alameda", # Country & State/Prov or State & County "date": "April 2, 1988", # Date media was captured "labels": "foo, bar, baz", # Label CSV "url": "http://arctos.com?id=23" # Media detail page. },

Additional JSON media objects...

]