Trope API

Search by tropes with include and exclude filters, for bookstores, libraries and recommendation services.

Request

GET /v1/books/search
  ?include=enemies_to_lovers,slow_burn
  &exclude=love_triangle
  &genre=Romance
  &year_from=1800

Response

{
  "total": 1,
  "results": [{
    "id": "pride-and-prejudice",
    "title": "Pride and Prejudice",
    "author": "Jane Austen",
    "year": 1813,
    "tropes": ["enemies_to_lovers", "slow_burn"],
    "links": { "amazon": "https://…" }
  }]
}

Request parameters

include
Tropes the book must have (all of them), separated by commas.
exclude
Tropes the book must not have.
q
Text query: title or author.
genre
Genre, for example “Fantasy” or “Mystery & Thriller”.
country
The author’s country.
year_from, year_to
Range of publication years.
pages_from, pages_to
Range of page counts.

Access

The API is still in development. We discuss terms and pricing case by case, after the site launches.

Request early access