the worlds first recommendation engine for finding things to do hyperlocal, mobile, social v...
TRANSCRIPT
![Page 1: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/1.jpg)
the world’s first
recommendation enginefor finding things to do
hyperlocal, mobile, social
v
[email protected]@viking2917
![Page 2: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/2.jpg)
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.
![Page 3: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/3.jpg)
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!
![Page 4: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/4.jpg)
api overview
![Page 5: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/5.jpg)
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.
![Page 6: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/6.jpg)
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. [email protected], 774-313-8913
Mark Watkins (backup), [email protected], 508-395-0474
![Page 7: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/7.jpg)
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
![Page 8: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/8.jpg)
XML result
![Page 9: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/9.jpg)
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>
![Page 10: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/10.jpg)
![Page 11: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/11.jpg)
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)
![Page 12: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/12.jpg)
<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>
![Page 13: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/13.jpg)
<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>
![Page 14: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/14.jpg)
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)
![Page 15: The worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917](https://reader036.vdocument.in/reader036/viewer/2022062618/5513c4585503466f748b46db/html5/thumbnails/15.jpg)
Good luck & have fun!