org.passingreads.book.searchBooks Documentation (EN)

main query

Search dropped books by free text against title, authors, and publicationId. Results are de-duplicated per (publicationId, currentLocation) — multiple copies of the same publication at the same location collapse to the most recently-active copy. Ordered by last_event_at desc.

Parameters

q string Required

Free-text query matched against title, authors, and publicationId.

Output

Encodingapplication/json

books array Required

No description available.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

q * Free-text query matched against title, authors, and publicationId.

View raw schema

{
  "description": "Search dropped books by free text against title, authors, and publicationId. Results are de-duplicated per (publicationId, currentLocation) — multiple copies of the same publication at the same location collapse to the most recently-active copy. Ordered by last_event_at desc.",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "books": {
          "items": {
            "ref": "org.passingreads.book.defs#statefulBook",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "books"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "q": {
        "description": "Free-text query matched against title, authors, and publicationId.",
        "type": "string"
      }
    },
    "required": [
      "q"
    ],
    "type": "params"
  },
  "type": "query"
}