Search AbeBooks rare, antiquarian and used books.

Searches AbeBooks like its book search results page: title, author, publisher, ISBN, price with currency, seller name and listing link. First results page only (about 30 listings), read from the page's search-results JSON-LD. Returns an empty list when nothing matches.

No reports yetRead-only, no login

Site: AbeBooks, United States
Version: v1
Runs, last 7 days: No reports yet
sha256: 45241f3450c1…

Run it with your agent

after installing Wield

Ask in plain words. Your agent finds this recipe and calls it:

“Search AbeBooks rare, antiquarian and used books.”

Read-only: it changes nothing on the site. No login needed.

{
  "tool": "run",
  "arguments": {
    "recipe_id": "abebooks.com/search-books",
    "params": {
      "query": "first edition tolkien"
    }
  }
}

Requests

sent from your browser, in order

1GET/servlet/SearchResults?knAbeBooks book search results page /servlet/SearchResults?kn=…; read-only GET. The listings are in the script#item-list JSON-LD ItemList (itemListElement[].item), one Book per listing.

Parameters

from your agent

querystringrequiredTitle, author, ISBN or keyword, e.g. 'first edition tolkien', 'signed book', '9783404150854'

Returns

to your agent

booksobject[]author, currency, image, isbn, price, publisher, seller, title, url

querystring

Where it can send

www.abebooks.com

Anything else is blocked by the extension.

Reads from your session

Nothing. Your browser attaches the site's cookies by itself.

Used only in requests to the addresses on the left. Never sent to wield.run or your agent.

Checks

a run passes when

length(output.books) > `0`
length(output.books[?starts_with(url, 'https://www.abebooks.com/')]) == length(output.books)
length(output.books[?title != `null`]) == length(output.books)

Raw recipe

Served as canonical JSON from /api/v1/recipes/abebooks.com/search-books, so its sha256 matches the ETag and the index.

Check it yourself

curl -s https://wield.run/api/v1/recipes/abebooks.com/search-books | shasum -a 256
# 45241f3450c14ade83e97addcab941b38f26319d92691174ef6d68718cad78f6

abebooks.com/search-books.json, v1

{
  "description": "Searches AbeBooks like its book search results page: title, author, publisher, ISBN, price with currency, seller name and listing link. First results page only (about 30 listings), read from the page's search-results JSON-LD. Returns an empty list when nothing matches.",
  "effect": "read",
  "id": "abebooks.com/search-books",
  "keywords": [
    "abebooks",
    "books",
    "rare books",
    "antiquarian",
    "used books",
    "first edition",
    "signed book",
    "bookseller",
    "antiquariat",
    "gebrauchte bücher",
    "livres anciens",
    "libri usati"
  ],
  "output": {
    "schema": {
      "properties": {
        "books": {
          "items": {
            "properties": {
              "author": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "currency": {
                "description": "ISO currency code of the price, e.g. USD",
                "type": [
                  "string",
                  "null"
                ]
              },
              "image": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "isbn": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "price": {
                "description": "Listing price in the currency below",
                "type": [
                  "number",
                  "null"
                ]
              },
              "publisher": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "seller": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "title": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "title",
              "url"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "query": {
          "type": "string"
        }
      },
      "required": [
        "query",
        "books"
      ],
      "type": "object"
    },
    "value": "{query: params.query, books: (steps.search.items || `[]`)[?name && url].{title: name, author: author.name, publisher: publisher.name, isbn: isbn, price: offers.price, currency: offers.priceCurrency, seller: offers.seller.name, image: image, url: url}}"
  },
  "params": {
    "additionalProperties": false,
    "properties": {
      "query": {
        "description": "Title, author, ISBN or keyword, e.g. 'first edition tolkien', 'signed book', '9783404150854'",
        "maxLength": 100,
        "minLength": 2,
        "type": "string"
      }
    },
    "required": [
      "query"
    ],
    "type": "object"
  },
  "provenance": {
    "method": "har",
    "notes": "GET /servlet/SearchResults?kn=…, the site's own book search page. The HTML carries a JSON-LD ItemList (script#item-list) with one Book per listing: name, isbn, author, publisher, image, url, and offers with price, currency and seller. The site's ?s= homepage URL in the work item shows promotions, so it was not used. Prices are shown in the visitor's currency (USD here).",
    "recorded_at": "2026-11-08T15:40:00.000Z",
    "recorded_by": "wield-forge (claude-haiku agent)"
  },
  "requires_login": false,
  "schema": "https://wield.run/schema/recipe/v1.json",
  "site": {
    "country": "US",
    "id": "abebooks.com",
    "language": "en",
    "name": "AbeBooks",
    "origin": "https://www.abebooks.com",
    "origins": [
      "https://www.abebooks.com"
    ]
  },
  "steps": [
    {
      "description": "AbeBooks book search results page /servlet/SearchResults?kn=…; read-only GET. The listings are in the script#item-list JSON-LD ItemList (itemListElement[].item), one Book per listing.",
      "expect": {
        "content_type": "html",
        "status": [
          200
        ]
      },
      "extract": {
        "embedded_json": {
          "required": false,
          "selector": "script#item-list",
          "vars": {
            "items": "itemListElement[].item"
          }
        }
      },
      "id": "search",
      "request": {
        "headers": {
          "Accept": "text/html"
        },
        "method": "GET",
        "query": {
          "kn": "{{params.query}}"
        },
        "url": "/servlet/SearchResults"
      }
    }
  ],
  "task": "Search AbeBooks rare, antiquarian and used books",
  "tos": {
    "notes": "Not reviewed. One search page per call, the same page a visitor loads. The site's terms on automated access were not checked.",
    "reviewed": false
  },
  "verify": {
    "checks": [
      "length(output.books) > `0`",
      "length(output.books[?starts_with(url, 'https://www.abebooks.com/')]) == length(output.books)",
      "length(output.books[?title != `null`]) == length(output.books)"
    ],
    "example_params": {
      "query": "first edition tolkien"
    },
    "max_ms": 8000
  },
  "version": 1
}