get.tags

Returns a list of auto-generated tags associated with the specified API key.

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]
sort  - (string)  The field with which to order the entries. Default is 'added'.
order - (string)  The order in which to return the entries. Default is 'descending'.
limit - (integer) The number of entries to return. Default is 25.
page  - (integer) The current page of entries to return. Default is 1.

• Fields to sort by: instances, recent and added
• Supported ordering: ascending, descending and random

Example Request

The following GET and POST parameters will return 10 tags in random order:

key   = API_KEY
order = random
page  = 1
limit = 10

Example Responses

The value of each returned entry is a string representing the returned tag:

@instances      - The number of times this tag has been used in a search.
@date_created   - The date this tag was first used.
@date_last_used - The date this tag was last used.

Files

• get.tags.xml
• get.tags.json
• get.tags.php

Valid URLs

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