Skills/Books/Search books

Search books

0.1 credits / search

Searches a large bibliographic catalog by title, author name, or keyword and returns matching works with their key facts. Each result includes the title, authors, first publication year, edition count, ISBNs, and subject tags. Use this to discover a book or browse an author's output.

Use when

You are looking for a book, an author's works, or books on a topic and want the matches with their key facts.

Not for

Getting the full record of one already-identified book, or resolving a known ISBN.

Cost

0.1 credits / search

What it accepts

Set these inside the intent when you run it.

queryoptional

A free-text search query for a keyword, topic, or subject.

titleoptional

A specific book title to search for by exact title.

authoroptional

An author name to list that author's works.

languageoptional

ISO 639-1 language code to localize and rank results.

What you get back

A list of matching book works, each with title, authors, first publish year, edition count, ISBNs, and subjects.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Books skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/books/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"search","query":"books about artificial intelligence","title":"The Road","author":"Ursula K. Le Guin","language":"en"}}'

Example requests

  • ›Find books by Cormac McCarthy
  • ›Books about the French Revolution
  • ›What books did Ursula Le Guin write?