Trove Help Trove home

Hardcover token

Hardcover is a book tracking and discovery platform with rich metadata: covers, descriptions, community ratings, review counts, moods, and tags. To use it as a metadata provider in Trove, you need a free API token from your Hardcover account.

Get Your Token

  1. Sign up or log in at hardcover.app
  2. Go to Account > API to open the API Access page
  3. Copy the token from the text box. It starts with Bearer followed by a long string beginning with eyJ...
Hardcover API Access page showing the Bearer token

Configure Trove

  1. Open Settings > Metadata 1
  2. Enable the Hardcover checkbox
  3. Paste the token (without the Bearer prefix) into the API Token field
  4. Click Save Configurations
Trove Metadata 1 settings with the Hardcover token field

Hardcover is now active as a metadata provider. Give it a priority for the fields you want from it in Library metadata (Settings › Metadata 2). The same token can also sync your reading progress to Hardcover; see Device settings.

Troubleshooting

ProblemWhat to check
Authentication errorsMake sure you removed the Bearer prefix. Check for extra spaces at the start or end of the token.
Token stopped workingHardcover tokens expire after 1 year. Go back to the API page and copy the new token. Hardcover may also reset tokens during their beta period.
No results for a bookHardcover's coverage is broad but not exhaustive. Verify the book exists on hardcover.app by searching manually.