API’s. They’re snazzy.

API’s are nifty.

Human/Computer: GUIAS

Computer/More complex Computer: API

How it works!

API Awesomeness

XML, JSON, Whatever

URL1’s and 0’s

1’s and 0’s

Anatomy of an API call

The Base URL The Query The Key

http://BASEURL?query=QUERY&api-key=KEY

If you want to try it out (reference):http://code.google.com/apis/chart/image/

https://chart.googleapis.com/chart? cht=<chart_type> &chd=<chart_data> &chs=<chart_size> &...additional_parameters...

https://chart.googleapis.com/chart? cht=p3& chs=250x100& chd=t:60,40& chl=Hello|World

Rainfall data• Monday: 8• Tuesday: 50• Weds: 33• Thursday: 55

reference: http://code.google.com/apis/chart/image/

Rainfall data• Monday: 8• Tuesday: 50• Weds: 33• Thursday: 55

https://chart.googleapis.com/chart? cht=lc &chs=200x125 &chd=t:8,50,33,55

https://code.google.com/apis/ajax/playground/

Get to know your Times API’s• Article Search API • Most Popular API• Movie Reviews API• Times Newswire API• TimesPeople API• TimesTags API• Real Estate listings API• Community API• Best Sellers API • Campaign Finance API• Congress API• Districts API• NY State Legislature API

Internal NYTimes Data

External data they’re hosting

for fun

More about queries!• Search terms

q=puppies

Begin date and end dateq=puppies&begin_date=20110828

• Fields requested backq=puppies&fl=headline,date

• Rank (the order)q=puppies&sort=oldest

• page(what group of 10 we’re on)q=puppies&page = 3

page

http://developers.nytimes.com/

Cheat sheet!!!11!http://www.upables.org/APIClass/cheatsheet.html

Common returned Query items (fl =…)•web_url•Snippet•lead_paragraph•Abstract•print_page•Blog•Source•multimedia

Let’s give it a go!developer.nytimes.com/docs/read/article_search_api_v2

• Headline• Keywords• pub_date• document_type• news_desk• Byline• type_of_material• _id• word_count

{"response": {"meta":{"hits":24226,"time":303,"offset":0}, "docs":[

{"headline":{"seo":"A Chicken Thighs Recipe With Mediterranean Flavor","main":"A Chicken’s Tour of the Mediterranean","content_kicker":"City Kitchen","print_headline":"A Chicken’s Tour of the Mediterranean"}"byline":{"person":[{"organization":"","role":"reported","firstname":"David","rank":1,"lastname":"TANIS"}],"original":"By DAVID TANIS"}},

{"headline":{"seo":"Hamptons Chickens Get a Modern Coop by ARO Architects","main":"The Eggs Are Happy, Too ","content_kicker":"Q&A","kicker":"Q&A","print_headline":"The Eggs Are Happy, Too"},

"byline":{"person":[{"organization":"","role":"reported","firstname":"Steven","rank":1,"lastname":"KURUTZ"}],"original":"By STEVEN KURUTZ"}},

]},"status":"OK","copyright":"Copyright (c) 2013 The New York Times Company. All Rights Reserved."}

www.programmableweb.com