the world’s first

recommendation enginefor finding things to do

hyperlocal, mobile, social

v

mark@goby.com@viking2917

what is goby?

goby® helps consumers to find things to do. From concerts to hiking to museums,

goby helps plan your free time

goby® helps marketers reach and influence in-market consumers before they’ve

decided what to do next.

unmatched depth & breadth of content

Goby has more concerts than

Goby has more activities than

Goby has more restaurant listings than

Goby has more sporting event listings than

Goby has more vacation homes than

Goby has more b&b’s than

3

350 categories and millions of things to do!

api overview

key api components

searchinputs: {category ID or string}, {Location id/string or lat/lon}, {optional date range}

output: XML describing result set (by pages)

resultinput: ID

output: XML describing result (an entity or listing), metadata, data sources

utility functionsget location ID by Strings, get Category ID by name, get category tree, …

other capabilitiesAPIs for bookmarking, lists, recommendations, what’s nearby, etc.

logistics and help

you will need a key/token to access the API0f510dae95d40e75e6c25ccc69ccb6fd

online API Browser for help:http://qa.goby.com/partner/inspector/view

points of contactJacob Novero, API usage. jacob@goby.com, 774-313-8913

Mark Watkins (backup), mark@goby.com, 508-395-0474

example query

find all events in Boston:

http://qa.goby.com/partner/search/getResults?

categoryID=75&locationID=55563&sort[dir]=asc&sort[label]=relevance&pag

e=1&date=&partner_token=token

XML result

a sample use case

find all museums in bostonget the id for museums

get the id for Boston

run the query

http://qa.goby.com/partner/category/getMatches?name=museums(xml will tell you id = 54)

http://qa.goby.com/partner/location/getMatches?name=boston%20ma (xml will tell you id = 55563)

http://qa.goby.com/partner/search/getResults?

categoryID=54&locationID=55563&partner_token=<token>Will return results xml, which can then be parsed and rendered

to see all categories:http://qa.goby.com/partner/utils/getAllCategories?partner_token=<token>

additional search parameters

dates (for event queries)uses unix time stamps, so for concerts this weekend:

http://qa.goby.com/partner/search/getResults?categoryID=83&locationID=55563&date=1316174400-1316347200

sorts&sort[dir]={asc, desc}&sort[label]={relevance, title, distance}

e,g. &sort[dir]=asc&sort[label]=relevance

pagination&page=n (e.g. &page=1)

filters(not covered today)

<resultset totalAvailable="8" filterAvailable="8"><query>...</query><settings>...</settings><sponsored/><results>

<result ordinal="0"><resultID>6823201</resultID><facets>

<StringFacet name="TITLE">...</StringFacet><VenueFacet name="VENUE">...</VenueFacet><StringFacet name="CALL_TO_ACTION_URL">...</StringFacet><LocationFacet name="LOC1">...</LocationFacet><StringFacet name="IMAGE1">...</StringFacet><CategoryFacet name="CATEGORY">...</CategoryFacet><CategoryFacet name="CATEGORY">...</CategoryFacet><CategoryFacet name="CATEGORY">...</CategoryFacet><DateTimeFacet name="DateTime">...</DateTimeFacet><AffiliateActionFacet name="AffiliateAction">...</AffiliateActionFacet>

</facets><distanceFromQueryLocation>3.086013160475668</distanceFromQueryLocation><score>8.0</score><count>5</count><groupId>6823201</groupId><descriptionLength>0</descriptionLength><timeRange reference="../facets/DateTimeFacet/DateTime"/><editDistanceFromQueryLocation>0.06642230000000637</editDistanceFromQueryLocation><entityTitle>Toro Y Moi</entityTitle><entityLocName>BOSTON</entityLocName><entityLocState>MA</entityLocState><entityLocType>CITY</entityLocType><entityIsCrawlable>true</entityIsCrawlable><isSponsored>false</isSponsored><siteReviewId>13644</siteReviewId><web_url_resultset>...</web_url_resultset><web_url_result>...</web_url_result></result>

<result ordinal="1">...</result>

<resultset totalAvailable="75" filterAvailable="75"><query>...</query><settings><results_per_page>15</results_per_page><filters>...</filters><sorts>

<sort name="relevance"><label>relevance</label><method>relevance</method><facet>relevance</facet><dir>ASC</dir></sort><sort name="date"><label>date</label><method>number_span</method><facet>date</facet><dir>ASC</dir></sort><sort name="distance"><label>distance</label><method>distance</method><facet>distance</facet><dir>ASC</dir></sort><sort name="title"><label>title</label><method>string</method><dir>ASC</dir><facet>title</facet></sort>

</sorts><modules>...</modules></settings><sponsored/><results>...</results></resultset>

entity-level information: the result API

Museum of Fine Arts in Boston is ID 1902277

To get entity details:http://qa.goby.com/api/result/getEntity?entityID=1902277?partner_token=<token>

Standard facets:location, title, website, phone number, categories are enumerated

each facet is sourced

many facets are enumerated by source (e.g. descriptions, destination url)

Good luck & have fun!