View
214
Download
0
Category
Tags:
Preview:
Citation preview
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!
Recommended