get.image

This service is used to fetch a set of images previously discovered by Snaggr. All images discovered by Snaggr are given an md5 has of their globally unique URL. This is used by Snaggr to reference the corresponding image in other services.

About

Supported Formats

• XML
• JSON
• PHP

Attributes

Cacheable   - Yes
Cache TTL   - 5 Mins.
Secure      - No
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 the hash ids of the desired images. [REQUIRED]

Example Request

The following GET or POST parameters will attempt to return Snaggr metadata for 3 images. Results are returned in the order they are requested.

key    = API_KEY
ids[0] = a5b554562ce92be14e4aa98bf17159d2
ids[1] = b30fbaad7c3b86951f9ecb29ebef48bb
ids[2] = 48c49416b99055c6b3e27dd6c8482878

Example Responses

@id         - A 32-character md5 hash of the image's direct url. Snaggr references the image using this hash.
@instances  - The number of times this image has been found.
@date_first - The date this image was first discovered.
@date_last  - The last time this date was found.
@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

• get.image.xml
• get.image.json
• get.image.php

Valid URLs

• http://rest.snag.gr/images/get.image.xml
• http://rest.snag.gr/images/get.image.json
• http://rest.snag.gr/images/get.image.php

Helpful Links

• post.search
• get.search
• Images Overview