Books to Scrape Catalog API
A live, read-only interface to the public Books to Scrape demonstration catalog. Browse all source-published categories, paginate book cards, and retrieve complete book detail pages. The source supports category navigation and pagination only; its pages expose no search, price-range, or sort controls, so those filters are not invented here. Prices and ratings are explicitly demonstration data on the source.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the Books to Scrape Catalog API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/074697f3-3e06-4a34-92f6-535e343e3a7b/categories' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY"Endpoints
Inputs and response fields for every endpoint in this API.
GETCategories/categories
Returns every category link in the source navigation. The returned slug is the exact value accepted by the `category` filter on GET /books and by GET /categories/{category}. The source navigation publishes category values but no search, price, or sort filter values.
Input
No input parameters.
Response
countintegeritemsobject[]items[].namestringitems[].slugstringitems[].books_pathstringitems[].source_urlstringnotes?string[]source_urlstringFields marked ? are optional.
GETCategory detail/categories/{category}
Resolves a category slug returned by GET /categories, follows its source pagination, and returns the exact count computed from the final source page.
Input
categoryRequiredPath · stringExact source category slug from GET /categories.
Example: poetry_23
Response
categoryobjectcategory.namestringcategory.slugstringcategory.books_pathstringcategory.source_urlstringpage_sizeintegerbook_countintegerpage_countintegerlast_page_urlstringfirst_page_urlstringGETBooks/books
Returns one source catalog page of book cards. `page` is one-based and follows the source's numbered pages. `category` is optional and must be an exact slug from GET /categories. Category and pagination are the complete set of source-supported browsing controls observed; search, price filtering, and sorting are unavailable on the source. This operation does not fetch each book's detail page; use the returned source_identifier with GET /books/{book_id}.
Input
pageOptionalQuery · integer, min: 1, default: 1One-based source page number.
Example: 1
categoryOptionalQuery · string | nullOptional exact source category slug returned by GET /categories.
Example: poetry_23
Response
itemsobject[]items[].price?objectitems[].price.amountnumber | nullitems[].price.currencystringitems[].price.source_textstringitems[].titlestringitems[].rating?objectitems[].rating.labelstringitems[].rating.value?integer | nullitems[].category?objectitems[].category.namestringitems[].category.slugstringitems[].category.books_pathstringitems[].category.source_urlstringitems[].source_urlstringitems[].availability?objectitems[].availability.statusstringitems[].availability.quantity?integer | nullitems[].availability.source_textstringitems[].cover_image_url?string | nullitems[].source_identifierstringpaginationobjectpagination.pageintegerpagination.category?string | nullpagination.next_page?integer | nullpagination.page_sizeintegerpagination.page_countintegerpagination.total_itemsintegerpagination.previous_page?integer | nullpagination.returned_countintegersource_urlstringFields marked ? are optional.
GETBook detail/books/{book_id}
Fetches one live source detail page. Pass `source_identifier` from GET /books unchanged; the response includes the breadcrumb/category, cover, description, rating, availability, all product-information table rows, source metadata, and the source's demonstration-data warning.
Input
book_idRequiredPath · stringExact source_identifier returned by GET /books, not a URL.
Example: a-light-in-the-attic_1000
Response
price?objectprice.amountnumber | nullprice.currencystringprice.source_textstringtitlestringrating?objectrating.labelstringrating.value?integer | nullcategory?objectcategory.namestringcategory.slugstringcategory.books_pathstringcategory.source_urlstringsource_urlstringbreadcrumbs?object[]breadcrumbs[].namestringbreadcrumbs[].source_urlstringdemo_notice?string | nulldescription?string | nullavailability?objectavailability.statusstringavailability.quantity?integer | nullavailability.source_textstringreview_count?integer | nullcover_image_url?string | nullsource_metadata?objectsource_identifierstringproduct_informationobjectproduct_information.tax?objectproduct_information.tax.amountnumber | nullproduct_information.tax.currencystringproduct_information.tax.source_textstringproduct_information.upc?string | nullproduct_information.attributes?objectproduct_information.availability?objectproduct_information.availability.statusstringproduct_information.availability.quantity?integer | nullproduct_information.availability.source_textstringproduct_information.product_type?string | nullproduct_information.number_of_reviews?integer | nullproduct_information.price_excluding_tax?objectproduct_information.price_excluding_tax.amountnumber | nullproduct_information.price_excluding_tax.currencystringproduct_information.price_excluding_tax.source_textstringproduct_information.price_including_tax?objectproduct_information.price_including_tax.amountnumber | nullproduct_information.price_including_tax.currencystringproduct_information.price_including_tax.source_textstringFields marked ? are optional.
Don’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.