Skip to main content

Amazon Cookie Setup

Amazon metadata works out of the box, but if you run into 503 errors or rate limiting, providing a browser session cookie gives Booklore a way to look like a regular logged-in user. The cookie is optional but recommended for the most reliable results.

Use a Secondary Account

Consider using a secondary Amazon account for this. Automated requests from Booklore could theoretically trigger Amazon's bot detection on the account you use.

  1. Open your regional Amazon site (e.g., amazon.com, amazon.co.uk) and sign in
  2. Open your browser's developer tools (F12, or Cmd+Option+I on Mac)
  3. Switch to the Network tab
  4. Refresh the page so new requests appear
  5. Click the first request in the list (the main page load)
  6. In the Headers panel, scroll down to Request Headers and find the Cookie field
  7. Copy the entire cookie value

Browser developer tools showing the Cookie header in Amazon's request headers

The cookie is a long string containing multiple key-value pairs separated by semicolons. Copy the whole thing.

Paste It into Booklore​

  1. Open Settings > Metadata 1
  2. Under Amazon, select your Region from the dropdown
  3. Paste the cookie string into the Cookie field
  4. Click Save

Booklore Metadata 1 settings showing the Amazon region dropdown and cookie field

That's it. Booklore will include the cookie when fetching metadata from Amazon, which gives access to richer results and avoids rate limits.

Troubleshooting​

ProblemWhat to check
Still getting 503 errorsThe cookie may have expired. Repeat the process to grab a fresh one. Make sure you're signed in to Amazon before capturing.
Metadata missing or sparseMake sure the Region dropdown matches the Amazon site you got the cookie from. A cookie from amazon.co.uk won't work for amazon.com.
Different regions neededIf your library has books from multiple Amazon regions, you'll need to update the cookie and region when switching. Booklore stores one cookie at a time.
Cookie seems too shortMake sure you copied the full value from the Cookie request header, not a single Set-Cookie response header. The request cookie is one long combined string.
Cookie Lifespan

Amazon session cookies typically last a few weeks before expiring. When metadata fetches start failing again, just repeat the steps above to grab a new cookie.