Method: /tag

Retrieve information about a tag.

Invocation

• This method can be invoked using either HTTP GET or HTTP POST.
• This method requires an API key

Request Parameters

Parameter	Description	Type	Extra
key	Zvents Developer API key	String	required
id	ID of the tag	Integer	required

Example Request

http://www.zvents.com/rest/tag?id=8&key=YOUR_API_KEY

Response Parameters

The response lists attributes of the requested tag

Parameter	Description	Type
id	The unique ID for the tag.	Integer
name	The name of the tag.	String

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<rsp status="ok">
  <stream_count>1</stream_count>
  <tag id="8">
    <name>jazz</name>
  </tag>
</rsp>

Output Fields

Note: The REST API does not return all possible fields for each item by default. Since some response fields are not used by most API users, these fields are suppressed from the response by default in order to reduce latency for the common calls. Additional fields can be enabled in the response using the fields parameters documented in the 'Optimizing API calls for performance' section.

Output Formats

REST responses can be returned in a number of different formats include XML, JSON and CSV. Read the documentation on output formats.

Possible Errors

This method may return one of the following errors.

• Unknown Tag ID: The tag ID requested does not exist.
• Invalid API Key: The API key supplied is not valid.
• Call Limit Exceeded: The API key has exceeded the daily maximum number of calls.

Output Fields

Note: The REST API does not return all possible fields for each item by default. Since some response fields are not used by most API users, these fields are suppressed from the response by default in order to reduce latency for the common calls. Additional fields can be enabled in the response using the fields parameters documented in the 'Optimizing API calls for performance' section.

Output Formats

REST responses can be returned in a number of different formats include XML, JSON and CSV. Read the documentation on output formats.