AbeBooks/Iberlibro Search Web Services End User Guide
Contents
1. Stephen King http search2 abebooks com search currency EUR amp author stephen 20king amp clientkey lt your client key here gt Example 3 Search for the title Cujo http search2 abebooks com search currency EUR amp title cujo amp clientkey lt your client key here gt Example 4 Search for the author Stephen King and the title Cujo http search2 abebooks com search currency EUR amp author stephen 20king amp title cujo amp amp clientkey lt your client key here gt Example 5 Search for the keyword horror http search2 abebooks com search currency EUR amp keyword horror amp clientkey lt your client key here gt Secondary Search Parameters Secondary search parameters are optional criteria that may be added to any search request to refine a search Secondary search parameters that are not provided in the search request will be automatically set to the default values as outlined below For example minprice is assumed to be O for any search where the minprice parameter is not provided Parameter Description Example Default Value Name Value minprice Must be a positive number Limits the 12 0 search to only books above the value corresponding value in USD specified by this parameter maxprice Must be a positive number Limits the 25 No limit search to only books below the value corresponding value in USD specified by this parameter vendorlocation Three letter country ISO code s2. Example 1 Search for listings titled Cujo and specify shipping to Great Britain GBR http search2 abebooks com search currency EUR amp title cujo amp destinationcountry GBR amp clientkey lt your client key here gt e Example 2 Search for listings titled Cujo and specify priority shipping http search2 abebooks com search currency EUR amp title cujo amp shiprate p amp clientkey lt y our client key here gt Controlling Book Record Format outputsize The outputsize parameter is used to determine how much detail is included in each search result All search requests may include one of the following values e outputsize micro e outputsize short e outputsize medium e outputsize long If an outputsize is not provided in the search request then outputsize medium will be used as the default value Sample search request URLs containing the outputsize Parameter AbeBooks Search Web Services End User Guide 6 Yor AbeBooks Yor IberLibro com e Example 1 Search for the ISBN 0451172817 and specify outputsize as micro http search2 abebooks com search currency EUR amp isbn 045117281 7 amp outputsize micro amp clientkey lt your client key here gt e Example 2 Search for the ISBN 0451172817 and specify outputsize as short http search2 abebooks com search currency EUR amp isbn 0451172817 amp outputsize short amp clientkey lt your client key here gt e Example 3 Search for
3. 72817 amp sortorder 15 amp clie ntkey lt your client key here gt Limiting the Number of Search Results The number of matching search results returned for each request can be controlled by the maxresults parameter If not provided in the search request the default number of search results returned will be 50 The maximum number of results that can be returned is 2000 Sample search request URL containing the maxresults Parameter AbeBooks Search Web Services End User Guide 12 Yor AbeBooks ar IberLibro com e Example 1 Search for the ISBN 0451172817 and limit the output to include 25 results http search2 abebooks com search currency EUR amp isbn 0451172817 amp maxresults 25 amp c lientkey lt your client key here gt Interpreting Error Messages Validation Errors Example Entering an invalid parameter Misspelling a search parameter i e sororder for sortorder lt xml version 1 0 encoding UTF 8 gt lt searchResults gt lt messages gt Invalid parameter name provided sororder lt messages gt lt searchResults gt Example Entering a malformed parameter value Parameter value entering in an incorrect format i e isbn 01 234567 34 for 0123456734 lt xml version 1 0 encoding UTF 8 gt lt searchResults gt lt messages gt Invalid ISBN value provided isbn 01 234567 34 lt messages gt lt searchResults gt Example Entering an invalid value for a numeric field with
4. Cost gt lt minShipDays gt 3 lt minShipDays gt lt maxShipDays gt 7 lt maxShipDays gt lt listingUrl gt www abebooks com servlet SearchResults bi 555203965 lt listingUrl gt lt Book gt lt searchResults gt outputsize short Short Record Format lt xml version 1 0 encoding UTF 8 gt lt searchResults gt lt Book gt lt bookId gt 555203965 lt bookId gt lt isbni0 gt 0451172817 lt isbn10 gt lt isbn13 gt 9780451172817 lt isbn13 gt lt listingCondition gt VG Itd lt listingCondition gt lt quantity gt 1 lt quantity gt lt vendorCurrency gt USD lt vendorCurrency gt lt listingPrice gt 1 94 lt listingPrice gt lt firstBookShipCost gt 4 75 lt firstBookShipCost gt lt extraBookShipCost gt 2 5 lt extraBookShipCost gt AbeBooks Search Web Services End User Guide 8 Wr AbeBooks Yr IberLibro com lt minShipDays gt 3 lt minShipDays gt lt maxShipDays gt 7 lt maxShipDays gt lt listingUrl gt www abebooks com servlet SearchResults bi 555203965 lt listingUrl gt lt author gt King Stephen lt author gt lt title gt Needful Things lt title gt lt publisherName gt Random House lt publisherName gt lt catalogImage gt http isbn abebooks com mz 17 45 0451172817 jpg lt catalogimage gt lt Book gt lt searchResults gt outputsize medium Medium Record Format lt xml version 1 0 encoding UTF 8 gt lt searchResults gt lt Book gt lt bookId gt 555203965 lt bookId gt lt i
5. Wor AbeBooks ar IberLibro com AbeBooks Iberlibro Search Web Services End User Guide Specifying Authorization Credentials Client Key All requests made to the search web service must include a clientkey parameter This client key value is obtained from AbeBooks Iberlibro and is used to authorize users of the search service The client key is case sensitive so the key 4398db55 fdf2 485d 92f8 f09b59344f94 is considered to be different from 4398DB55 FDF2 485D 92F8 F09B59344F94 If the client makes a search request with an invalid or unrecognized client key then the server will return an HTTP status of 401 UNAUTHORIZED error message Creating Search Requests Each search request is a URL that contains request parameters These parameters fall into the following categories Authorization Credentials Book Search Parameters Output Value Parameters Sort Order Record Format The parameter names are always lower case and are case sensitive as are most parameter values All search requests are performed at http search2 abebooks com Sample search request URL http search2 abebooks com search currency EUR amp isbn 0451161351 amp clientkey lt your client key here gt Book Search Parameters Primary Search Parameters There are four primary search parameters of which at least one must be specified in every search request AbeBooks Search Web Services End User Guide 1 Wer AbeBooks Parameter Description Name currenc
6. ee USA Search all countries appendix Limits the search to only AbeBooks Search Web Services End User Guide 3 Wor AbeBooks bookcondition minsellerrating binding signed freeshipping expeditedshipping minpubyear maxpubyear firstedition dustjacket vendorid We recommend using three letter ISO codes instead of two letter codes books being sold by vendors in the country specified by this parameter filter by book condition newonly new books only usedonly used books only used used and unclassified books only filter by minimum seller rating filter by cover type limit to signed books limit to only freeshipping US not applicable for Europe limit to only expedited shipping US not applicable for Europe minimum publication year maximum publication year limit to first editions limit to books with dustjacket an abe vendor id numerals only Yeo IberLibro com newonly usedonly used 2 3 4 5 softcover hardcover yes yes yes 1 9999 1 9999 yes yes 2345346346 Search all conditions Search all ratings Search all bindings Search both signed and unsigned Search all shipping rates Search all shipping speeds Search all publication years Search all publication years Search all editions Search books both with and without dustjackets Search all AbeBooks Iberlibro vendors As of August 1 2008 we no longer accept the two le
7. iption gt Fine in Fine dustwrapper Unread The last Castle Rock story First Edition cloth lt vendorDescription gt lt Book gt lt searchResults gt Sorting Search Results sortorder The parameter sortorder is an optional parameter that indicates how the request result should be sorted The parameter accepts a sort order number value those values are listed below If this parameter is not provided the default sort order will be by price ascending Sort order integer Description 0 Newly listed books first AbeBooks Search Web Services End User Guide 11 Wor AbeBooks ar IberLibro com oO oo NOUO BR W N Be e e e an e oO Price descending Price ascending This is the default sort order United Kingdom Sellers first Author names descending Author names ascending Book title descending Book title ascending German sellers first French sellers first Spanish sellers first Italian sellers first Book seller rating descending Sample search request URLs containing the sortorder Parameter Example 1 Search for the ISBN 0451172817 and specify results to be sorted by highest to lowest list price http search2 abebooks com search currency EUR amp isbn 0451172817 amp sortorder 1 amp clien tkey lt your client key here gt Example 2 Search for the ISBN 0451172817 and specify results to be sorted by the highest to lowest rated sellers http search2 abebooks com search currency EUR amp isbn 04511
8. l version 1 0 encoding UTF 8 gt lt searchResults gt lt messages gt Words such as the 8 in etc are not searched Please enter some content words i e nouns or verbs and try again lt messages gt AbeBooks Search Web Services End User Guide 14 Wor AbeBooks ar IberLibro com lt searchResults gt Example Entering a minprice greater than maxprice Entering 30 for minprice and 20 for maxprice lt xml version 1 0 encoding UTF 8 gt lt searchResults gt lt messages gt Please enter only whole numbers greater than zero in the Price fields The max value must be larger than the min value lt messages gt lt searchResults gt Authentication Errors If an invalid or unrecognized client key is included in the search request then an http status code 401 SC_UNAUTHORIZED error message will be returned Service Level Errors If the Search Web Service is unresponsive then an http status code 503 SC_SERVICE_UNAVAILABLE error message will be returned Appendix Currency names ISO 4217 http en wikipedia org wiki ISO_4217 Three letter country codes http en wikipedia org wiki ISO_3166 1 Alpha 3 AbeBooks Search Web Services End User Guide 15
9. minimum and maximum limits Entering a maxresults parameter value of 2500 lt xml version 1 0 encoding UTF 8 gt lt searchResults gt lt messages gt Illegal value for maxresults 2500 Value must be an integer between 0 and 2000 lt messages gt lt searchResults gt AbeBooks Search Web Services End User Guide 13 Yor AbeBooks ar IberLibro com Example Entering an invalid value for a numeric field with a minimum limit only Entering 20 for minprice lt xml version 1 0 encoding UTF 8 gt lt searchResults gt lt messages gt Illegal value for minprice 20 Value must be an integer greater than or equal to 0 lt messages gt lt searchResults gt Example Entering an invalid parameter value Entering big instead of long for outputsize lt xml version 1 0 encoding UTF 8 gt lt searchResults gt lt messages gt Invalid outputsize parameter specified big lt messages gt lt searchResults gt Example Entering more than 1 value for the same parameter Entering multiple values for the parameter outputsize i e outputsize big amp outputsize long lt xml version 1 0 encoding UTF 8 gt lt searchResults gt lt messages gt Too many outputsize parameters specified lt messages gt lt searchResults gt Example Entering a blank word in a primary search field Entering a non searchable word such as NOT in the author search parameter lt xm
10. sbni0 gt 0451172817 lt isbn10 gt lt isbn13 gt 9780451172817 lt isbn13 gt lt listingCondition gt VG Itd lt listingCondition gt lt quantity gt 1 lt quantity gt lt vendorCurrency gt USD lt vendorCurrency gt lt listingPrice gt 1 94 lt listingPrice gt lt firstBookShipCost gt 4 75 lt firstBookShipCost gt lt extraBookShipCost gt 2 5 lt extraBookShipCost gt lt minShipDays gt 3 lt minShipDays gt lt maxShipDays gt 7 lt maxShipDays gt lt listingUrl gt www abebooks com servlet SearchResults bi 555203965 lt listingUrl gt lt author gt King Stephen lt author gt lt title gt Needful Things lt title gt lt publisherName gt Random House lt publisherName gt AbeBooks Search Web Services End User Guide 9 Yor AbeBooks yir IberLibro com lt catalogImage gt http isbn abebooks com mz 17 45 0451172817 jpg lt catalogImage gt lt vendorName gt SpanishS4 lt vendorName gt lt vendorLocation gt S4City Brazil lt vendorLocation gt lt vendorld gt 2344918 lt vendorld gt lt sellerRating gt 8 lt sellerRating gt lt keywords gt MODERN FIRSTS STEPHEN KING HORROR SHORT STORIES lt keywords gt lt subjects gt lt subject gt Horror lt subject gt lt subjects gt lt bindingType gt S lt bindingType gt lt editionType gt F lt editionType gt lt Book gt lt searchResults gt outputsize long Long lt xml version 1 0 encoding UTF 8 gt lt searchResults gt lt Book gt lt bookId gt 593187245 l
11. search currency EUR amp title cujo amp minprice 10 amp signed yes amp clientkey lt yourclient key here gt e Example 8 http search2 abebooks com search currency EUR amp title cujo amp minprice 10 amp minpubyear 1990 amp maxpubyear 1995 amp clientkey lt your client key here gt e Example 9 http search2 abebooks com search currency EUR amp title cujo amp firstedition yes amp clientkey lt your client key here gt e Example 10 http search2 abebooks com search currency EUR amp title cujo amp dustjacket YES amp clientkey lt your client key here gt Output Value Parameters AbeBooks Search Web Services End User Guide 5 Yor AbeBooks ar IberLibro com Output value parameters are optional parameters that determine how certain output values such as shipping price are calculated Output value parameters that are not provided in the search request will be automatically set to the default values as outlined below For example destinationcountry is set to USA if not provided in the search request Parameter Description Example Default Name Value Value destinationcountry Two or three letter country ISO code see appendix GBR USA All shipping prices will be calculated with the destination country set to the country specified by this parameter shiprate Either S or P All shipping rates will be calculated in P S either S standard or P priority rates Sample search request URLs containing Output Value Parameters e
12. t bookId gt lt isbn10 gt 0670839531 lt isbn1i0 gt lt isbn13 gt 9780670839531 lt isbn1i3 gt lt listingCondition gt Very Good lt listingCondition gt lt quantity gt 1 lt quantity gt lt vendorCurrency gt USD lt vendorCurrency gt lt listingPrice gt 58 0 lt listingPrice gt lt firstBookShipCost gt 4 75 lt firstBookShipCost gt lt extraBookShipCost gt 2 5 lt extraBookShipCost gt lt minShipDays gt 3 lt minShipDays gt lt maxShipDays gt 7 lt maxShipDays gt AbeBooks Search Web Services End User Guide 10 Wor AbeBooks Yr IberLibro com lt listingUrl gt www abebooks com servlet SearchResults bi 593187245 lt listingUrl gt lt author gt KING Stephen lt author gt lt title gt NEEDFUL THINGS lt title gt lt publisherName gt Random House lt publisherName gt lt catalogImage gt http isbn abebooks com mz 17 45 0451172817 jpg lt catalogIimage gt lt vendorName gt test lt vendorName gt lt vendorLocation gt test tes Canada lt vendorLocation gt lt vendorId gt 51539110 lt vendorId gt lt sellerRating gt 55 lt sellerRating gt lt keywords gt MODERN FIRSTS STEPHEN KING HORROR SHORT STORIES lt keywords gt lt subjects gt lt subject gt Horror lt subject gt lt subjects gt lt bookJacket gt J lt bookJacket gt lt bindingType gt H lt bindingType gt lt editionType gt F lt editionType gt lt publicationYear gt 1991 lt publicationYear gt lt vendorPrice gt 58 0 lt vendorPrice gt lt vendorDescr
13. the ISBN 0451172817 and specify outputsize as medium default http search2 abebooks com search currency EUR amp isbn 045117281 7 amp outputsize mediu m amp clientkey lt your client key here gt e Example 4 Search for the ISBN 0451172817 and specify outputsize as long http search2 abebooks com search currency EUR amp isbn 045117281 7 amp outputsize long amp clientkey lt your client key here gt Sample outputsize Record Returns Always Examine Returned Search Result Elements Carefully Note that the output samples below are complete examples that include all possible fields If a particular field is not populated for a listing in the search result that field will be omitted from the record Therefore actual results may contain fewer fields than these examples but will NEVER contain more fields outputsize micro Micro Record Format lt xml version 1 0 encoding UTF 8 gt lt searchResults gt lt Book gt lt bookId gt 555203965 lt bookId gt AbeBooks Search Web Services End User Guide 7 Wor AbeBooks Yr lberLibro com lt isbni0 gt 0451172817 lt isbn10 gt lt isbn13 gt 9780451172817 lt isbn13 gt lt listingCondition gt VG Itd lt listingCondition gt lt quantity gt 1 lt quantity gt lt vendorCurrency gt USD lt vendorCurrency gt lt listingPrice gt 1 94 lt listingPrice gt lt firstBookShipCost gt 4 75 lt firstBookShipCost gt lt extraBookShipCost gt 2 5 lt extraBookShip
14. tter country code gb please use uk instead If this is corrected in the future we will retain backwards compatibility with uk Sample search request URLs containing Secondary Search Parameters AbeBooks Search Web Services End User Guide Wor AbeBooks Yr lberLibro com e Example 1 Search for items titled Cujo that are listed for U 10 00 or more http search2 abebooks com search currency EUR amp title cujo amp minprice 10 amp clientkey lt your client key here gt e Example 2 Search for items titled Cujo that are listed for U 10 00 or less http search2 abebooks com search currency EUR amp title cujo amp maxprice 10 amp clientkey lt your client key here gt e Example 3 Search for items titled Cujo that are listed for between U 1 00 and U 10 00 http search2 abebooks com search currency EUR amp title cujo amp minprice 1 amp maxprice 10 amp clientkey lt your client key here gt e Example 4 http search2 abebooks com search currency EUR amp title cujo amp minprice 10 amp bookconditi on newonly amp clientkey lt your client key here gt e Example 5 http search2 abebooks com search currency EUR amp title cujo amp minprice 10 amp minsellerrati ng 4 amp clientkey lt your client key here gt e Example 6 http search2 abebooks com search currency EUR amp title cujo amp minprice 10 amp binding har dcover amp clientkey lt your clientkey here gt e Example 7 http search2 abebooks com
15. y ALWAYS NEEDED default value USD Three letter currency ISO code see appendix All prices will be returned in the currency specified by this parameter destinationcountr Y ALWAYS NEEDED default value USA Three letter Country ISO code see appendix All shipping prices will be calculated with the destination country set to the Country specified by this parameter The shipping prices will be shown in lt firstBookShipCost gt isbn A 10 or 13 character ISBN value The name or names of all authors of a book Spaces and other special characters must be URL encoded author title The title of a book Spaces and other special characters must be URL encoded keyword This word is searched against all text fields in a book listing Note that this is not the vendor assigned keyword pubname Search by publisher name vendorid Search by AbeBooks Iberlibro Seller Yes IberLibro com Example Values EUR USD DEU FRA ESP ITA 9780708915110 3799503005 Margaret Attwood Bluebeard 27s Egg and Other Stories cooking Random House 7876454657 numerals only Sample search request URLs containing Primary Search Parameters e Example 1 Search for the ISBN 0451161351 http search2 abebooks com search currency EUR amp isbn 0451161351 amp clientkey lt your client key here gt AbeBooks Search Web Services End User Guide Wor AbeBooks Yor IberLibro com Example 2 Search for the author
Download Pdf Manuals
Related Search