Skip to main content
GET
Get Wishlist
Returns the products on a public Amazon wishlist or gift list. Each product carries its ASIN as product_id, the price shown on the list in cents as buy_box_price, whether it can be added to cart as available, and the list owner’s quantity_requested and quantity_purchased. Pass a product_id to Get Product Details or Get Product Offers with the response’s retailer to get more.

Pricing

This is a metered data call, billed whether or not you go on to order. A retry loop bills every attempt: check GET /wallet/me rather than retrying into a 402.
There is no MPP counterpart: wishlists are API-key only.

Supported lists

Any other host, including other Amazon marketplaces, is rejected with 400 before anything is billed. A private list, or a url on a supported host that is not a list, comes back from the upstream as an error. A long list takes a while to read. pages caps how many pages of the list are fetched; omit it to read the whole list.

Errors

Authorizations

Authorization
string
header
required

Zinc API key (Bearer zn_...)

Headers

authorization
string | null

Query Parameters

url
string
required

A public Amazon wishlist or gift list url, on amazon.com, amazon.co.uk or amazon.ca

Required string length: 1 - 2048
pages
integer | null

Read at most this many pages of the list (default: all)

Required range: x >= 1

Response

Successful Response

An Amazon wishlist or gift list, as scraped from its public page.

retailer
string
required
url
string | null
wishlist_title
string | null
wishlist_description
string | null
products
WishlistProduct · object[]