Brings back a valuation of any item, based on the myriad factors affecting that item, all of which are exposed in the Market Price Illustration tool.
[item_id] is a mandatory parameter. No results will be returned without it being specified correctly.
You can retrieve an Item ID by:
Using the API call to getAllItemIDs in conjunction with a machine, or
Using the API call to getAllItemIDsByPublisherAttribute in conjunction with a publisher ID, name or folder, or
Using the API call to getItemsFeaturingTracksByArtistName in conjunction with an artist name, or
Outside of the API entirely, just looking at the very bottom of an item's landing page (in the case of this link, Item ID 9411).
The following call, substituting 992 for [item_id]:
will return a response containing an array similar to the following:
The only field in the arrayed response that is likely to interest you is the valuation_amount (and possibly the valuation_type). The other key->value pairs are merely returned to confirm to you the correct item has been valued (i.e. in the example, 992 equates to the cassette (format_type_info) game Bun Fun (machine_type_group_name) for the Acorn Electron (machine_type_group_name).
For the sake of completeness, the following table shows the data types returned:
||Value Data Type
||Stated Machine Compatibility
||Media Format Of Item
||Type Of Valuation
In the case of the example, the valuation_type returned is of the "market_price" of the given item and, ideally, every item would return a valuation of this type. However, the vast majority of items will return a valuation_type of "base_price". A full description of what the base price is, along with forms to generate it for specific machines and formats can be found using the Market Price Illustration tool but, in essence, it's the minimum price you would expect to pay for a format for the machine specified.