Formats & Editions

3min

Formats & Editions Results
When making a request with the  type  parameter set to  type=formats_editions  Rainforest API will return data from the Formats & Editions popup (typically shown on books and collectables product pages to list all of the ASINs of different formats of the current ASIN) for the product specified in either the  asin  and  amazon_domain  parameters or the  url  parameter.
Formats & Editions data is retrieved from the Formats & Editions popup for a single product on Amazon.
Formats & Editions Page
﻿
An example of the JSON object returned from a Formats & Editions request is shown below:
JSON
{
  "formats_editions": [
    {
      "position": 1,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B087N9WX3R/ref=monarch_sidesheet",
      "asin": "B087N9WX3R",
      "title": "The Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/81lNtrKCIZL._AC_.jpg",
      "rating": 4.5,
      "ratings_total": 29,
      "specifications": [
        {
          "name": "Publisher",
          "value": "knowledge house"
        },
        {
          "name": "Publication Date",
          "value": "April 24, 2020"
        }
      ],
      "publication_date": "April 24, 2020",
      "publisher": "knowledge house",
      "price": {
        "value": 1.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "1.99"
      }
    },
    {
      "position": 2,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B08BZRMCWZ/ref=monarch_sidesheet",
      "asin": "B08BZRMCWZ",
      "title": "The Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/81ZOonH3icL._AC_.jpg",
      "rating": 4.5,
      "ratings_total": 13,
      "specifications": [
        {
          "name": "Publisher",
          "value": "knowledge house"
        },
        {
          "name": "Publication Date",
          "value": "June 29, 2020"
        }
      ],
      "publication_date": "June 29, 2020",
      "publisher": "knowledge house",
      "price": {
        "value": 1.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "1.99"
      }
    },
    {
      "position": 3,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B08RP7BP6N/ref=monarch_sidesheet",
      "asin": "B08RP7BP6N",
      "title": "The Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/81MZF3nYsyL._AC_.jpg",
      "rating": 5,
      "ratings_total": 57,
      "specifications": [
        {
          "name": "Publisher",
          "value": "Createspace Independent Publishing Platform"
        },
        {
          "name": "Publication Date",
          "value": "December 30, 2020"
        }
      ],
      "publication_date": "December 30, 2020",
      "publisher": "Createspace Independent Publishing Platform",
      "price": {
        "value": 1.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "1.99"
      }
    },
    {
      "position": 4,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B09VPZNLFY/ref=monarch_sidesheet",
      "asin": "B09VPZNLFY",
      "title": "Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/616uBhd0tDL._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publication Date",
          "value": "March 15, 2022"
        }
      ],
      "publication_date": "March 15, 2022",
      "price": {
        "value": 1.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "1.99"
      }
    },
    {
      "position": 5,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B06XQLMTTL/ref=monarch_sidesheet",
      "asin": "B06XQLMTTL",
      "title": "The Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/81IqSDJ80CL._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publisher",
          "value": "Prabhat Prakashan"
        },
        {
          "name": "Publication Date",
          "value": "March 18, 2017"
        }
      ],
      "publication_date": "March 18, 2017",
      "publisher": "Prabhat Prakashan",
      "price": {
        "value": 2,
        "currency": "USD",
        "symbol": "$",
        "raw": "2"
      }
    },
    {
      "position": 6,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B083Z4YD6M/ref=monarch_sidesheet",
      "asin": "B083Z4YD6M",
      "title": "The Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/71RNIs3KHgL._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publisher",
          "value": "Shrine of Knowledge"
        },
        {
          "name": "Edition",
          "value": "1"
        },
        {
          "name": "Publication Date",
          "value": "January 15, 2020"
        }
      ],
      "publication_date": "January 15, 2020",
      "publisher": "Shrine of Knowledge",
      "edition": "1",
      "price": {
        "value": 2,
        "currency": "USD",
        "symbol": "$",
        "raw": "2"
      }
    },
    {
      "position": 7,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-Illustrated-ebook/dp/B09LTLNF7G/ref=monarch_sidesheet",
      "asin": "B09LTLNF7G",
      "title": "Complete Works of Jane Austen (Illustrated)",
      "image": "https://m.media-amazon.com/images/I/81E4yDOcoGL._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publication Date",
          "value": "November 14, 2021"
        }
      ],
      "publication_date": "November 14, 2021",
      "price": {
        "value": 2.98,
        "currency": "USD",
        "symbol": "$",
        "raw": "2.98"
      }
    },
    {
      "position": 8,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B09NL2K12K/ref=monarch_sidesheet",
      "asin": "B09NL2K12K",
      "title": "Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/71Ybz9bTyzL._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publication Date",
          "value": "December 12, 2021"
        }
      ],
      "publication_date": "December 12, 2021",
      "price": {
        "value": 2.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "2.99"
      }
    },
    {
      "position": 9,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B09PKHXQ3J/ref=monarch_sidesheet",
      "asin": "B09PKHXQ3J",
      "title": "Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/71xhbuX1guS._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publication Date",
          "value": "January 1, 2022"
        }
      ],
      "publication_date": "January 1, 2022",
      "price": {
        "value": 2.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "2.99"
      }
    },
    {
      "position": 10,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-illustrated-ebook/dp/B09QL69VF8/ref=monarch_sidesheet",
      "asin": "B09QL69VF8",
      "title": "Complete Works of Jane Austen illustrated edition)",
      "image": "https://m.media-amazon.com/images/I/71xhbuX1guS._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publication Date",
          "value": "January 16, 2022"
        }
      ],
      "publication_date": "January 16, 2022",
      "price": {
        "value": 2.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "2.99"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "has_next_page": true
  }
}
{
  "formats_editions": [
    {
      "position": 1,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B087N9WX3R/ref=monarch_sidesheet",
      "asin": "B087N9WX3R",
      "title": "The Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/81lNtrKCIZL._AC_.jpg",
      "rating": 4.5,
      "ratings_total": 29,
      "specifications": [
        {
          "name": "Publisher",
          "value": "knowledge house"
        },
        {
          "name": "Publication Date",
          "value": "April 24, 2020"
        }
      ],
      "publication_date": "April 24, 2020",
      "publisher": "knowledge house",
      "price": {
        "value": 1.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "1.99"
      }
    },
    {
      "position": 2,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B08BZRMCWZ/ref=monarch_sidesheet",
      "asin": "B08BZRMCWZ",
      "title": "The Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/81ZOonH3icL._AC_.jpg",
      "rating": 4.5,
      "ratings_total": 13,
      "specifications": [
        {
          "name": "Publisher",
          "value": "knowledge house"
        },
        {
          "name": "Publication Date",
          "value": "June 29, 2020"
        }
      ],
      "publication_date": "June 29, 2020",
      "publisher": "knowledge house",
      "price": {
        "value": 1.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "1.99"
      }
    },
    {
      "position": 3,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B08RP7BP6N/ref=monarch_sidesheet",
      "asin": "B08RP7BP6N",
      "title": "The Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/81MZF3nYsyL._AC_.jpg",
      "rating": 5,
      "ratings_total": 57,
      "specifications": [
        {
          "name": "Publisher",
          "value": "Createspace Independent Publishing Platform"
        },
        {
          "name": "Publication Date",
          "value": "December 30, 2020"
        }
      ],
      "publication_date": "December 30, 2020",
      "publisher": "Createspace Independent Publishing Platform",
      "price": {
        "value": 1.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "1.99"
      }
    },
    {
      "position": 4,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B09VPZNLFY/ref=monarch_sidesheet",
      "asin": "B09VPZNLFY",
      "title": "Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/616uBhd0tDL._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publication Date",
          "value": "March 15, 2022"
        }
      ],
      "publication_date": "March 15, 2022",
      "price": {
        "value": 1.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "1.99"
      }
    },
    {
      "position": 5,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B06XQLMTTL/ref=monarch_sidesheet",
      "asin": "B06XQLMTTL",
      "title": "The Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/81IqSDJ80CL._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publisher",
          "value": "Prabhat Prakashan"
        },
        {
          "name": "Publication Date",
          "value": "March 18, 2017"
        }
      ],
      "publication_date": "March 18, 2017",
      "publisher": "Prabhat Prakashan",
      "price": {
        "value": 2,
        "currency": "USD",
        "symbol": "$",
        "raw": "2"
      }
    },
    {
      "position": 6,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B083Z4YD6M/ref=monarch_sidesheet",
      "asin": "B083Z4YD6M",
      "title": "The Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/71RNIs3KHgL._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publisher",
          "value": "Shrine of Knowledge"
        },
        {
          "name": "Edition",
          "value": "1"
        },
        {
          "name": "Publication Date",
          "value": "January 15, 2020"
        }
      ],
      "publication_date": "January 15, 2020",
      "publisher": "Shrine of Knowledge",
      "edition": "1",
      "price": {
        "value": 2,
        "currency": "USD",
        "symbol": "$",
        "raw": "2"
      }
    },
    {
      "position": 7,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-Illustrated-ebook/dp/B09LTLNF7G/ref=monarch_sidesheet",
      "asin": "B09LTLNF7G",
      "title": "Complete Works of Jane Austen (Illustrated)",
      "image": "https://m.media-amazon.com/images/I/81E4yDOcoGL._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publication Date",
          "value": "November 14, 2021"
        }
      ],
      "publication_date": "November 14, 2021",
      "price": {
        "value": 2.98,
        "currency": "USD",
        "symbol": "$",
        "raw": "2.98"
      }
    },
    {
      "position": 8,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B09NL2K12K/ref=monarch_sidesheet",
      "asin": "B09NL2K12K",
      "title": "Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/71Ybz9bTyzL._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publication Date",
          "value": "December 12, 2021"
        }
      ],
      "publication_date": "December 12, 2021",
      "price": {
        "value": 2.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "2.99"
      }
    },
    {
      "position": 9,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-ebook/dp/B09PKHXQ3J/ref=monarch_sidesheet",
      "asin": "B09PKHXQ3J",
      "title": "Complete Works of Jane Austen",
      "image": "https://m.media-amazon.com/images/I/71xhbuX1guS._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publication Date",
          "value": "January 1, 2022"
        }
      ],
      "publication_date": "January 1, 2022",
      "price": {
        "value": 2.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "2.99"
      }
    },
    {
      "position": 10,
      "link": "https://www.amazon.com/Complete-Works-Jane-Austen-illustrated-ebook/dp/B09QL69VF8/ref=monarch_sidesheet",
      "asin": "B09QL69VF8",
      "title": "Complete Works of Jane Austen illustrated edition)",
      "image": "https://m.media-amazon.com/images/I/71xhbuX1guS._AC_.jpg",
      "ratings_total": 0,
      "specifications": [
        {
          "name": "Publication Date",
          "value": "January 16, 2022"
        }
      ],
      "publication_date": "January 16, 2022",
      "price": {
        "value": 2.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "2.99"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "has_next_page": true
  }
}
﻿
Rainforest API returns the following properties for Formats & Editions requests:
Paginating Results
Amazon returns 10 Formats & Editions per page. To request more formats & editions issue additional requests incrementing the  page  parameter.
Note  you should inspect the  pagination.has_next_page  property to determine if another page is available.
Property
Type
Description
formats_editions
array
An array of Formats & Editions objects, containing each of the Formats & Editions shown on the Formats & Editions popup. The Formats & Editions object has the following properties:
position
number
The position (1-based) of the format/edition on the current page.
﻿
title
string
The title of the format/edition.
﻿
link
string
A link to the product page for the format/edition ASIN.
﻿
asin
string
The ASIN of the format/edition.
﻿
image
string
An image URL to the image of the format/edition, if shown.
﻿
rating
number
An rating of the image of the format/edition, if shown.
﻿
ratings_total
number
An total number of customer ratings the format/edition has received, if shown.
﻿
specifications
array
An array of specifications containing name and value properties for each of the specifications for the format/edition.
﻿
edition
string
An name of the edition, if shown.
﻿
format
string
An name of the format, if shown.
﻿
publication_date
string
An publication date of the format/edition, if shown.
﻿
price
object
Price Object 
The price object contains details about the format/editions pricing.
﻿
symbol
string
The currency symbol, i.e. $ for USD.
﻿
value
number
The price of the format/edition.
﻿
currency
string
The currency of the format/edition as a ISO 4217 currency code.
﻿
raw
string
The raw price as displayed on the format/edition.
pagination
object
An object containing details of the current Formats & Editions page and whether a next page is available. To paginate you should specify the page number in your request's page parameter .
current_page
number
The current page number.
﻿
has_next_page
boolean
Set to true if a next page of results is available.
﻿
Next Steps
     Formats & Editions Parameters﻿

Property	Type	Description
formats_editions	array	An array of Formats & Editions objects, containing each of the Formats & Editions shown on the Formats & Editions popup. The Formats & Editions object has the following properties: position number The position (1-based) of the format/edition on the current page. title string The title of the format/edition. link string A link to the product page for the format/edition ASIN. asin string The ASIN of the format/edition. image string An image URL to the image of the format/edition, if shown. rating number An rating of the image of the format/edition, if shown. ratings_total number An total number of customer ratings the format/edition has received, if shown. specifications array An array of specifications containing name and value properties for each of the specifications for the format/edition. edition string An name of the edition, if shown. format string An name of the format, if shown. publication_date string An publication date of the format/edition, if shown. price object Price Object The price object contains details about the format/editions pricing. symbol string The currency symbol, i.e. $ for USD. value number The price of the format/edition. currency string The currency of the format/edition as a ISO 4217 currency code. raw string The raw price as displayed on the format/edition.
pagination	object	An object containing details of the current Formats & Editions page and whether a next page is available. To paginate you should specify the page number in your request's page parameter . current_page number The current page number. has_next_page boolean Set to true if a next page of results is available.

Updated 16 Aug 2024

Did this page help you?

Charts

Wishlist