ZoneTag : Suggested Tags API

Developer Support and Community

If you're building something cool with the suggested tags web service, please let us know or just swing on by the mailing list and shoot the breeze with other developers/users. Do it all in the zonetag-dev discussion group.

Request URL

http://zonetag.research.yahooapis.com/services/rest/V1/suggestedTags.php?

Request parameters

See information on constructing REST queries

Parameter	Value	Description
apptoken	string (required)	The application token. You can get your app token here.
cellid	Integer - up to 7 digits	The cellid of the cellular tower
lac	Integer - up to 7 digits	The Location Area Code (LAC) of the cellular tower
mnc	Integer - up to 3 digits	The Mobile Network Code (MNC) of the cellular tower
mcc	Integer - up to 3 digits	The Mobile Country Code (MCC) of the cellular tower
cellhistory	mnc:lac:cellid@timeoffset	Collection of individual terms that gives the user's location history.
timeoffset	Integer	Time offset in seconds from the moment the last reading was recorded (only used as part of the cellhistory parameter)
latitude	float: -90 to 90	The latitude of the starting location.
longitude	float: -180 to 180	The longitude of the starting location. If both latitude and longitude are specified, they will take priority over all other location data. If only one of latitude or longitude is specified, both will be ignored.
zip	Integer	The zip code of the starting location.
output	xml	Desired output format for tag suggestions.
ctxttime	integer	Local time of desired tag suggestions (UNIX time). Default is set to current time(PST).

Sample Request URL

http://zonetag.research.yahooapis.com/services/rest/V1/suggestedTags.php?apptoken=ZoneTagDemoToken&cellid=4995&lac=6045&mnc=380&mcc=310&output=xml

Response fields

Field	Description
suggestion	Envelope element that contains the suggestion information
id	Id of the suggestion list.
location	Contains estimated location of the requested suggestions.
city	City name of the current location
state	State name of the given suggestion (if applicable)
country	Country of the given suggestion.
zipcode	Postal code of the given suggestions
categories	Envelope node containing the list of the various tag categories
catid	Id number of the given category
name	Name of the category.
tags	Envelope node containing the various tags
text	Text of the suggested tag.
tagid	Unique id of the suggested tag (if applicable).
catid	Category of the suggested tag (if applicable).

Sample response

The following is a sample response for the cellid 4995-6045-380-310:

<?xml version="1.0" ?> <rsp stat="ok"><suggestion> <id>1153500902</id> <location> <country>USA</country> <state>California</state> <city>Berkeley</city> <zipcode>94704</zipcode> </location> <categories> <category> <name>Local</name> <catid>1</catid> </category> <category> <name>Recent</name> <catid>2</catid> </category> <category> <name>Venues</name> <catid>3</catid> </category> <category> <name>Events</name> <catid>4</catid> </category> <category> <name>Eats</name> <catid>5</catid> </category> <category> <name>Actions</name> <catid>6</catid> </category> <category> <name>GCal</name> <catid>7</catid> </category> <category> <name>SF</name> <catid>8</catid> </category> <category> <name>BBC sports</name> <catid>9</catid> </category> </categories> <tags> <tag><text>Carrie Burgener</text><catid>1</catid></tag> <tag><text>Yahoo! Research Berkeley</text><catid>1</catid></tag> <tag><text>Mor Naaman</text><catid>1</catid></tag> <tag><text>Nick Reid</text><catid>1</catid></tag> <tag><text>Dean Eckles</text><catid>1</catid></tag> <tag><text>Shane Ahern</text><catid>1</catid></tag> <tag><text>Marc Davis</text><catid>1</catid></tag> <tag><text>slide</text><catid>1</catid></tag> <tag><text>Lotus</text><catid>1</catid></tag> <tag><text>Simon King</text><catid>1</catid></tag> <tag><text>sunset</text><catid>1</catid></tag> <tag><text>Rahul Nair</text><catid>1</catid></tag> <tag><text>movie</text><catid>1</catid></tag> <tag><text>Lunch</text><catid>1</catid></tag> <tag><text>Dinner</text><catid>1</catid></tag> <tag><text>UC Berkeley</text><catid>1</catid></tag <tag><text>Cody's Books (Telegraph)</text><tagid>210</tagid><catid>3</catid></tag> <tag><text>Bear\'s Lair Pub</text><tagid>486</tagid><catid>3</catid></tag> <tag><text>Berekeley Art Museum - Pacific Film Archive</text><tagid>21150</tagid><catid>3</catid></tag> <tag><text>University Press Books</text><tagid>21151</tagid><catid>3</catid></tag> <tag><text>Zellerbach Hall A</text><tagid>21152</tagid><catid>3</catid></tag> <tag><text>Zellerbach Hall B</text><tagid>21153</tagid><catid>3</catid></tag> <tag><text>Pegasus Books</text><tagid>21257</tagid><catid>3</catid></tag> <tag><text>My Home Planet Earth</text><tagid>47379</tagid><catid>4</catid></tag> <tag><text>Math Around the World</text><tagid>47380</tagid><catid>4</catid></tag> <tag><text>Math Rules!</text><tagid>47377</tagid><catid>4</catid></tag> <tag><text>!rotate:right</text><catid>6</catid></tag> <tag><text>!rotate:left</text><catid>6</catid></tag> <tag><text>!scanr:wb</text><catid>6</catid></tag> <tag><text>RSL4 - Rocksteady Lounge</text><tagid>47354</tagid><catid>8</catid></tag> <tag><text>Ween at the Independent!</text><tagid>47356</tagid><catid>8</catid></tag> <tag><text>Overlap 03</text><tagid>47357</tagid><catid>8</catid></tag> <tag><text>Dabrye w/ Percee P & Mophono</text><tagid>47358</tagid><catid>8</catid></tag> <tag><text>Live: The Open</text><tagid>47362</tagid><catid>9</catid></tag> <tag><text>Awesome Woods takes lead</text><tagid>47363</tagid><catid>9</catid></tag> </tags></suggestion></rsp>

Errors

List error codes here

Error code	Description
1	Invalid apptoken.
2	Invalid usertoken.
3	Application rate-limit exceeded.
4	User rate-limit exceeded.
10	Invalid location values.
11	Invalid cellid.
12	Invalid lac.
13	Invalid mnc.
14	Invalid mcc.
15	Invalid latitude.
16	Invalid longitude.

Sample Error Message

The following is a sample error message:

<?xml version="1.0" encoding="utf-8" ?> <rsp stat="fail"> <err code="1" msg="Invalid apptoken"/> </rsp>

Rate Limit

We are only a prototype, small and tiny. So be nice and observe polite etiquette in your requests rates.

Terms of Use

ZoneTag web services are offered to you for non-commercial use, and are governed by the Yahoo! APIs Terms of Use and the ZoneTag web services Terms of Use.