Best Sellers API

1
Best Sellers API
2
(No Transcript)
3
Current Best-Seller List

• Must specify list-name parameter
• Leaving off date parameter gives current week
•  
• http//api.nytimes.com/svc/books/v2/lists/hardcove
  r-fiction.xml?api-keyapi-key

4
http//api.nytimes.com/svc/books/v2/lists/hardcove
r-fiction.xml?api-keyapi-key
5
Best-Seller List Names

• To get all possible list-name options, see the
  names service
•  
• http//api.nytimes.com/svc/books/v2/lists/names.xm
  l?api-keyapi-key

6
http//api.nytimes.com/svc/books/v2/lists/names.xm
l?api-keyapi-key
7
Previous Best-Seller List

• To get a previous list, specify a date parameter
  in the URL prior to the list-name.
• The date parameter does not have to be exact, we
  will find the closest list to the date you
  specified (going forward in time).
• http//api.nytimes.com/svc/books/v2/lists/2008-10-
  06/hardcover-fiction.xml?api-keyapi-key

8
http//api.nytimes.com/svc/books/v2/lists/2008-10-
06/hardcover-fiction.xml?api-keyapi-key
9
Sorting Basic List

• List service can be sorted on the following
  fields
• isbn 
• list-name ( or just list )
• published-date (or just date)
• bestsellers-date 
• weeks-on-list
• rank 
• rank-last-week
• http//api.nytimes.com/svc/books/v2/lists/2008-10-
  06/hardcover-fiction.xml?sort-byweeks-on-listsor
  t-orderDESCapi-keyapi-key

10
Best-Seller List Search

• More flexible option for retrieving list
  information
• Search parameters are same as sort parameters
• isbn 
• list-name ( or just list )
• published-date (or just date)
• bestsellers-date 
• weeks-on-list
• rank 
• rank-last-week
• http//api.nytimes.com/svc/books/v2/lists.xml?date
  2008-10-06listhardcover-fictionapi-keyapi-ke
  y
• http//api.nytimes.com/svc/books/v2/lists.xml?date
  2008-10-06listhardcover-fictionweeks-on-list2
  sort-byrank-last-weeksort-orderDESCapi-keya
  pi-key

11
(No Transcript)
12
Best Seller Search

• Search for all lists for specific book, author
  and more
• Search and sort options are the following
• isbn 
• title
• price 
• publisher 
• contributor 
• author 
• age-group
• http//api.nytimes.com/svc/books/v2/lists/best-sel
  lers/history.xml?authorMcCarthyapi-keyapi-key
  
• http//api.nytimes.com/svc/books/v2/lists/best-sel
  lers/history.xml?authorMcCarthytitleRoadapi-ke
  yapi-key

13
http//api.nytimes.com/svc/books/v2/lists/best-sel
lers/history.xml?authorMcCarthyapi-keyapi-key

14
http//api.nytimes.com/svc/books/v2/lists/best-sel
lers/history.xml?authorMcCarthytitleRoadapi-ke
yapi-key
15
Sorting Best Seller Search

• All search fields may also be used as sort
  parameters
• isbn 
• title
• price 
• publisher 
• contributor 
• author 
• age-group
• http//api.nytimes.com/svc/books/v2/lists/best-sel
  lers/history.xml?authorGrishamsort-bytitleapi-
  keyapi-key

16
Show Us Your Apps

•  Check out the New York Times Developer Network
  forum and let us know what apps you are building.
•