1. the worlds first recommendation engine for finding things to do hyperlocal, mobile, social v mark@goby.com @viking2917

2. 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 theyve decided what to do next.

3. 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&bs than 3 350 categories and millions of things to do!

4. api overview

5. key api components search inputs: {category ID or string}, {Location id/string or lat/lon}, {optional date range} output: XML describing result set (by pages) result input: ID output: XML describing result (an entity or listing), metadata, data sources utility functions get location ID by Strings, get Category ID by name, get category tree, … other capabilities APIs for bookmarking, lists, recommendations, whats nearby, etc.

6. logistics and help you will need a key/token to access the API 0f510dae95d40e75e6c25ccc69ccb6fd online API Browser for help: http://qa.goby.com/partner/inspector/view points of contact Jacob Novero, API usage. jacob@goby.com, 774-313-8913jacob@goby.com Mark Watkins (backup), mark@goby.com, 508-395-0474mark@goby.com

7. example query find all events in Boston: http://qa.goby.com/partner/search/getResults?categoryID=75&locationID=555 63&sort[dir]=asc&sort[label]=relevance&page=1&date=&partner_token=tok en

8. XML result

9. a sample use case find all museums in boston get the id for museums get the id for Boston run the query http://qa.goby.com/partner/category/getMatches?name=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&location ID=55563&partner_token=<tokenhttp://qa.goby.com/partner/search/getResults?categoryID=54&location ID=55563&partner_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=

10. ... 1902277 Museum Of Fine Arts... First opened in 1876, this art museum is one of the best in the United States and has sponsored impressive shows on Monet and John Singer Sargent. The "MFA" has outstanding collections of Impressionist art, early American art and artifacts, and Asian and Egyptian art. The museum also hosts lectures, musical performances and films. Admission is USD15 for adults, USD13 for seniors and college studen... 2.229783146503829 869.0 15 1902277 400 0.05431460000001209 Museum Of Fine Arts BOSTON MA CITY true false 13551 http://www.goby.com/museums--near--boston-ma......

11. 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&d ate=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)

12. ... 6823201... 3.086013160475668 8.0 5 6823201 0 0.06642230000000637 Toro Y Moi BOSTON MA CITY true false 13644......

13. ... 15... relevance ASC date number_span date ASC distance ASC title string ASC title......

14. 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=1902277http://qa.goby.com/api/result/getEntity?entityID=1902277?partner_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)

15. Good luck & have fun!