Jainebooks Catalogue

Search the Jainebooks catalogue by title, author, publisher, subject or keyword, in any script. Returns a page of matching books, each with its jainebooks.org url, plus facets: how many of ALL matches fall in each language, subject and content type (id => count), so you can narrow with one more call. Filter with the ids that list_filters returns. Leave query empty to browse.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Words from the title, author, publisher or subject. Empty browses the whole catalogue.",
      "type": "string"
    },
    "language_id": {
      "description": "A language id from list_filters.",
      "type": "integer"
    },
    "subject_id": {
      "description": "A subject id from list_filters.",
      "type": "integer"
    },
    "content_type_id": {
      "description": "A content type id from list_filters, e.g. the one named Audiobook.",
      "type": "integer"
    },
    "sort": {
      "default": "relevance",
      "enum": [
        "relevance",
        "newest",
        "popular",
        "title"
      ],
      "type": "string"
    },
    "page": {
      "description": "Page number; 12 books per page.",
      "default": 1,
      "type": "integer"
    }
  }
}

Full details of one book by its slug (from search_books): description, contributors, subjects, page count, audio tracks and the jainebooks.org url where it can be read or downloaded. If the person notices a mistake in the details (wrong author, year, language, publisher) or a duplicate, send them to report_url — it opens the correction form on the book page for them to file with their own account.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The book slug, as returned by search_books.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

The vocabularies search_books filters by — languages, subjects and content types (pass their id), plus religions, traditions and series for context. Small and stable; call it once.

{
  "type": "object",
  "properties": {}
}