API’s.
They’re snazzy.
API’s are nifty.
Human/Computer: GUI
AS
Computer/More complex Computer: API
How it works!
URL
XML,
JSON,
Whatever
1’s and 0’s
API
Awesom
eness
1’s and 0’s
Anatomy of an API call
The Base URL
The Query
The Key
http://BASEURL?query=QUERY&api-key=KEY
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
If you want to try it out (reference):
http://code.google.com/apis/chart/image/
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
Internal
NYTimes Data
External data
they’re hosting
for fun
•
•
•
•
•
•
•
•
•
•
•
•
•
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
page
More about queries!
• Search terms
q=puppies
Begin date and end date
q=puppies&begin_date=20110828
• Fields requested back
q=puppies&fl=headline,date
• Rank (the order)
q=puppies&sort=oldest
• page(what group of 10 we’re on)
q=puppies&page = 3
http://developers.nytimes.com/
Cheat sheet!!!11!
http://www.upables.org/APIClass/cheatsheet.html
Let’s give it a go!
developer.nytimes.com/docs/read/article_search_api_v2
Common returned
Query items (fl =…)
• web_url
• Snippet
• lead_paragraph
• Abstract
• print_page
• Blog
• Source
• multimedia
•
•
•
•
•
•
•
•
•
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