Formats & Editions

4min

Formats & Editions Parameters
﻿GET  /request
The Formats & Editions Parameters are applicable 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. The parameters should be appended as querystring parameters to the Product Data API GET HTTP request.
Formats & Editions data is retrieved from the Formats & Editions popup for a single product on Amazon.
Formats & Editions Page
﻿
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.
For example, to request all  page=1  of Formats & Editions listings for the ASIN  B00B1GBS9O  on  amazon.com  the request would be:
HTTP
Curl
Node.js
Python
PHP
https://api.rainforestapi.com/request?api_key=demo&type=formats_editions&page=1&amazon_domain=amazon.com&asin=B00B1GBS9O
https://api.rainforestapi.com/request?api_key=demo&type=formats_editions&page=1&amazon_domain=amazon.com&asin=B00B1GBS9O
﻿
﻿
Formats & Editions Parameters
The following parameters are available for all requests made when  type=formats_editions .
Parameter
Required
Description
amazon_domain
optional
The Amazon domain to retrieve Formats & Editions for the product specified in the asin parameter from. For a full list of supported Amazon domains see Supported Amazon Domains .  
Note : If the amazon_domain and asin parameters are supplied then the url parameter is ignored.
asin
optional
The Amazon ASIN (product ID) to retrieve Formats & Editions for. Used in combination with the amazon_domain parameter.  
Note : If the asin and amazon_domain parameters are supplied then the url parameter is ignored.
url
optional
The Amazon product-page URL to retrieve Formats & Editions from.  
Note : If the url parameter is supplied then the amazon_domain and asin parameters are ignored.
page
optional
The current page of Formats & Editions to retrieve. Inspect the pagination.has_next_page property in the Formats & Editions results to see whether a next page of results is available.
max_page
optional
Use the max_page parameter to get multiple pages of results in one request. The API will automatically paginate through pages and concatenate the results into one response.  
See the Pagination docs for more information.
﻿
Next Steps
     Formats & Editions Results﻿

Parameter	Required	Description
amazon_domain	optional	The Amazon domain to retrieve Formats & Editions for the product specified in the asin parameter from. For a full list of supported Amazon domains see Supported Amazon Domains . Note : If the amazon_domain and asin parameters are supplied then the url parameter is ignored.
asin	optional	The Amazon ASIN (product ID) to retrieve Formats & Editions for. Used in combination with the amazon_domain parameter. Note : If the asin and amazon_domain parameters are supplied then the url parameter is ignored.
url	optional	The Amazon product-page URL to retrieve Formats & Editions from. Note : If the url parameter is supplied then the amazon_domain and asin parameters are ignored.
page	optional	The current page of Formats & Editions to retrieve. Inspect the pagination.has_next_page property in the Formats & Editions results to see whether a next page of results is available.
max_page	optional	Use the max_page parameter to get multiple pages of results in one request. The API will automatically paginate through pages and concatenate the results into one response. See the Pagination docs for more information.

Updated 16 Aug 2024

Did this page help you?

Charts

Wishlist