Digitalbook

Ask an agent to

• Find free audiobooks by Jane Austen and open a sample
• Add Pride and Prejudice to my liked shelf
• Play chapter 3 of the audiobook I have open

11 tools

• add_favorite

  Save a book to the signed-in reader's Digitalbook liked shelf. Takes the id reported by search_books.

  id: string

• close_sample

  Close whatever `open_sample` opened — the audiobook clip player or the ebook reader. Reports that nothing was open rather than failing.

• get_playbackread-onlyuntrusted content

  Report the audiobook open on the page: its chapters, which one the player is on, whether it is playing, and how far in. Call this before play_chapter or seek_playback — it is where the chapter numbers those take come…

• list_shelfread-onlyuntrusted content

  List the books on one of the reader's Digitalbook shelves. `liked` are books they saved, `started` books they have started listening to or reading, `purchased` books they have bought, and `viewed` the books viewed on…

  shelf: string

• open_sample

  Open a book's free sample on the reader's own screen — the clip player for an audiobook, the EPUB reader for an ebook. This is the one thing only the page can do, and it changes what the reader is looking at, so call…

  id: string

• pause_playback

  Pause the audiobook playing on the page. The position is kept, so play_chapter with no arguments picks it up again.

• play_chapter

  Start the audiobook on the page playing. `chapter` is the number get_playback lists, counting from 1; leave it out to resume the chapter the player is already on. `at` starts that many seconds in. This plays out loud…

  chapter: number?, at: number?

• remove_favorite

  Take a book off the signed-in reader's Digitalbook liked shelf. Takes the id reported by search_books or list_shelf.

  id: string

• search_booksread-onlyuntrusted content

  Search Digitalbook's own catalogue of free audiobooks and ebooks by keyword, title or author. Returns the matches plus a link to the full results page, which also merges partner titles (Amazon, Apple, Google, Open…

  query: string, format: string?, field: string?

• seek_playback

  Move the playhead within the chapter the audiobook is on. `to` is seconds from the start of that chapter — get_playback reports where it is now, so skipping forward is that plus however far. Use play_chapter to move…

  to: number

• set_market

  Change which market the reader is browsing (an ISO 3166-1 alpha-2 code). This is reader state rather than a search argument: the Digitalbook catalogue is not market-segmented, but the partner results merged into the…

  market: string