Amazon notes

From Helpful
Jump to: navigation, search
This article/section is a stub — probably a pile of half-sorted notes, is not well-checked so may have incorrect bits. (Feel free to ignore, fix, or tell me)
This hasn't been updated for a while, so could be outdated (particularly if it's about something that evolves constantly, such as software).

Images

General

The url consists of:

  • an image collection, or rather, server. Just choose the closest; all of them should generate images for all locations:
    • http://images.amazon.com/images/P/ (for America and Canada)
    • http://images-eu.amazon.com/images/P/ (for Germany and the UK, and probably France)
    • http://images-jp.amazon.com/images/P/ (for Japan)
    • http://ecx.images-amazon.com/images/P/ (?)
  • an ASIN (Amazon Standard Identification Number), which for books is just the ISBN without dashes
  • location ID:
    • 01: US/Canada
    • 02: UK
    • 03: Germany
    • 08: France
    • 09: Japan
    • The things that may vary between locations include:
      • Covers (seems to default to the 01 image on non-existing IDs)
      • effects like the pricedowns. (won't appear on non-existing IDs)
      • image names/availability (won't appear on non-existing IDs)
  • the command (see below)
  • an extension (seems ignored, so is rather optional; seems to serve a JPEG if this is empty, 'jpg','jpeg','png','gif', or 'bmp') -- or a 1x1 GIF if something is wrong with the command or extension.

Examples:

   http://images.amazon.com/images/P/4063636194.01.THUMBZZZ
http://images-eu.amazon.com/images/P/4063636194.03.22TZZZZZ.jpg

Commands

There seem to be four image sizes: (note that the quoted pixel sizes are approximate - they vary noticeably)

  • THUMB
    - Thumbnail - ~47x60px, but note
  • T
    - Tiny - ~70x90px, seems to be the default
  • M
    - Medium - 100x150px sort of scale
  • L
    - Large - 200x300px or 300x400px sort of scale


There seem to be two command formats, the underscore-list type and the eight-Z type:

Underscore-wrapped-and-delimited filter list, size code optional

(more flexible than the Z format)

Note that size T is assumed, so you need only add filters, for example http://images.amazon.com/images/P/0441003257.01._PD33_AA100_. Note that filter order can matter, depending on what the filters do. Some things act before filters (such as SC - probably taken out of the list before the rest is applied), while most are applied one after the other, left-to-right.

Notice for example the the difference in meaning between the last image and _AA100_PD33_.

Filters are two-letter codes and may have required and/or optional arguments. Most arguments are integers, which can sometimes be negative. A few filters have required options, but generally they have defaults where possible and sensible. Various filters are listed below:


Image sizing

  • Note: Nothing scales up; if you want a large image, start with something larger than the default T, using SC
  • SCcode
    selects a base size that isn't the default T. Example: _SCLZZZZZZZ_.
  • SXx
    ,
    SYx
    - Scales down one specified axis to pixel size, the other proportionally.
  • AAx
    - size down (if requested size is smaller) or white-pad (if larger) to a particular (square) size, x by x. (_AA100_) (If you want another color border, see BO.)
    • You should e.g. always get a 100x100 image with just _AA100_, since T is always (or rather, assuming it is) smaller than that
  • SSx
    - similar to AA (verify)
  • CRleft,top,width,height
    crop to this box.

Transformation

  • Apparently deprecated: (rotate right)
  • PTx
    : Rotate right. Default is no tilt (used to be slight tilt).
    • Used to be
      PUx
      and
      PVx
      for rotate left, right; there may well be a new rotate-left as well.
  • BLx
    : Blur
  • SHx
    : Sharpen (It seems ~30 will counteract the apparently bilinear resizing blur well)


Decoration

  • PB
    ,
    PC
    ,
    PA
    : Drop shadow: to the left, the right, advanced (figure out).
  • HLleft,top,width,height,opacity[,r,g,b]
    : Highlight box. RGB defaults to green. Opacity and RGB are in 0..255 scale.
  • PDx
    ,
    PEx
    : Price down image on the left, right: ('x% off' for 1..99) (enlarges image if done late or last)
  • PF
    : Show CD coming out of icon. Not in all locations (not 02, 03). Resizes the image to fit. Can apparently also take a size for itself, not figured out yet.
  • ZAurlencodedstr,left,top,width,height,fontname,fontsize,r,g,b
    : add text
    • font name can be 'times', 'arial', and 'verdenab'.
    • string is cut based on whether it is inside the described box (the last character may be half outside)
  • ZC
    seems an equivalent but box-centering version of ZA (i.e. replaces the 'left' coordinate based on image)
  • BOwidth,r,g,b
    adds a width-pixel border, by default in white
  • PIname,alignwhere,deltax,deltay
    adds a picture. Where to put it and by how much to move it tends to depend - at least if you want it to show up correctly - on the image itself. Image names largely depend on the country code. Example using 'sitb-dp-500-arrow' ('search inside this book'), which works in location 01.

Size-centric code, Z-padded, cut to eight characters

This article/section is a stub — probably a pile of half-sorted notes, is not well-checked so may have incorrect bits. (Feel free to ignore, fix, or tell me)

(Note: The other style, detailed above, is more flexible and predictable.)

Example: THUMBZZZ for 'basic thumbnail'

(Possibly deprecated(verify) - behaviour doesn't seem entirely consistent.)

Even something like 47SCTHUM exists, but note it does not seem to play by simple or apparently very logical rules when you use this shorthand format. I suggest you use the long form.

The previously mentioned sizes,
THUMB
,
T
,
M
, and
L
. Omitting a size seems to make it default to T - but it seems that the code cannot be all Zs, so you might as well just start with your chosen size code.

It seems you can append filters after the size, but there seems to be more to this, it does not quite act as I would expect. It may be that they simply added some similar-name functionality.

Previously observed, now seems not to work (use other style and PT instead):
  • T: Tilt left, drop shadow right
  • TL: Tilt left, drop shadow left
  • TR: Tilt right, drop shadow right
  • TRL: Tilt right, drop shadow left

Example: 20MTLZZZ


Note on rotation: I suspected amazon renamed and deprecated some things. This rotation, as well as the PU and PV filters in the other style, stopped working around Jul 2006. PT still works; as do PU/PV, which also didn't work for a few months(verify)).

See also

Link structure

This article/section is a stub — probably a pile of half-sorted notes, is not well-checked so may have incorrect bits. (Feel free to ignore, fix, or tell me)


locales → domains:

  • us : amazon.com
  • uk : amazon.co.uk
  • de : amazon.de
  • jp : amazon.co.jp
  • fr : amazon.fr
  • ca : amazon.ca

Websites and web services seem specific to each domain. Images are a slightly different story.


ASINs

  • are used by, and consistent between, the various amazon sites and affiliate sites (verify)
  • ISBN10s are a subset - you can use them literally.
  • are also created for other products, including ISBNless books, CDs and such.

Links

ASIN-based product links:

  • http://www.amazon.com/gp/product/0380789035/
  • http://www.amazon.com/o/ASIN/0380789035/
  • http://www.amazon.com/dp/0380789035/


Old, now-deprecated(verify) formats include obidos:

  • http://www.amazon.com/exec/obidos/tg/detail/-/0380789035
  • http://www.amazon.com/exec/obidos/ISBN=0195117891/ (specifically for ISBNs)

Searches

This article/section is a stub — probably a pile of half-sorted notes, is not well-checked so may have incorrect bits. (Feel free to ignore, fix, or tell me)


You cannot use ISBN13s as ASINs, though those starting with 978 can be converted to ISBN10. You can still use ISBN13s, e.g. in searches (which presumably works largely because ISBN13s are fairly unique numbers):

  • http://www.amazon.com/s/field-keywords=9780395898314



To read:

APIs

This hasn't been updated for a while, so could be outdated (particularly if it's about something that evolves constantly, such as software).

For infrastructure services, see Web_service_hosting_notes#Amazon_Infrastructure_Services


ECS / AWS

This article/section is a stub — probably a pile of half-sorted notes, is not well-checked so may have incorrect bits. (Feel free to ignore, fix, or tell me)

Previously known as Known as E-Commerce Service (ECS), now known as Associates Web Service (AWS), and, since that makes it confusable with amazon web services in general (also occasionally abbreviated as AWS [1])), also 'AWS E-commerce services'.


Note that you can access this via purely WSDL-mediated SOAP, but also via URLs like http://webservices.amazon.com/onca/xml?Service=AWSECommerceService.... The latter is more hardcoded, but can be a lot less bothersome (particularly in experiments) given amazon's complex WSDL.


ECS 3.0 service stopped on April 1, 2008, in favour of the the next version, 4.0 (available since 2004). In case you still have ECS3 code, see the 3→4 migration guide


ResponseGroup

Controls the set of details returned. (See also [2])

You can ask for a specific set of properties or use one of the predefined sets, such as:

  • Small: item-level data, such as:
    • ASIN
    • product title
    • product group (e.g. books)
    • product page URL
    • creator (author, artist, composer, directory, manufacturer, etc.)
    • manufacturer
    • (no pricing or availability),
  • Medium: Small plus sales information
    • sales rank
    • item details such as features
    • preview images
    • summary of price details (e.g. lowest offer)
    • editorial reviews
  • Large:
    • more detailed offer information than in Medium
    • More item metadata, such as an album's track titles,
    • BrowseNodes (place within amazon product hierarchy)
    • customer reviews
    • listmania lists
    • similar products
    • accessory products

Note that exact details differ depending on the search type, and the details present obviously vary per product.

Alexa Web Information Service (AWIS)

Mechanical Turk

FPS (Flexible Payments Service)

DevPay