get.search
Returns metadata associated with the provided search ids. These
ids can be found when using the
post.search API service.
About
Supported Formats
XMLJSONPHP
Attributes
Cacheable - Yes
Cache TTL - 5 Mins.
Secure - Yes
Metered - Yes
Limit - 1,000 Requests
Limit Cycle - 24 Hrs.
Parameters
key - (string) The API key associated with your application. [REQUIRED]
ids - (array) An array containing a list of search ids. [REQUIRED]
limit - (integer) The number of recent entries to return per specified object. Default is 5.
results - (bool) Used to determine whether to return associated image results. Default is FALSE.
Example Request
The following POST or GET data will return metadata associated with the corresponding set of search ids. It will also return the last 15 images discovered by the associated search:
key = API_KEY
ids[0] = 6e69685d22c94ffd42ccd7e70e246bd9
results = 1
limit = 15
Example Responses
If results is set to FALSE the
following metadata is returned along with the keywords associated
with the original search:
@id - A 32-character unique cache id the system attempted to clear.
@instances - The number of times this search has been performed.
@results - The estimated number of results the search originally yielded.
@date_first - The first time this search was performed.
@date_last - The last time this search was perfomed.
If results is set to TRUE the
following additional data is returned in the form of an image
result set:
@id - A 32-character md5 hash of the image's direct url. Snaggr references the image using this hash.
@source - The domain name source of this image.
title - The author-defined title of this image.
url - The direct URL to the full size of this image.
thumb - The direct URL to the thumbnail of this image.
context - The direct URL to the page this image was originally posted.
Files
Valid URLs
http://rest.snag.gr/images/get.search.xmlhttp://rest.snag.gr/images/get.search.jsonhttp://rest.snag.gr/images/get.search.php