La Feltrinelli APIlafeltrinelli.it ↗
Access La Feltrinelli's book catalog via API. Search books, browse categories, fetch bestsellers, new releases, preorders, and discounts with full metadata.
What is the La Feltrinelli API?
The La Feltrinelli API exposes 10 endpoints covering the full catalog of Italy's largest bookstore chain, returning fields such as EAN/ISBN, price, original_price, discount_percentage, publisher, author, and availability. You can retrieve live bestseller charts with ranked positions via get_bestsellers, browse new releases by time window, search by keyword or advanced title/author filters, and pull discounted titles segmented by promotion type.
curl -X GET 'https://api.parse.bot/scraper/610af7f7-8a72-44de-83e6-00bfc7cb9aa4/get_new_books_this_week?page=0&limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace lafeltrinelli-it-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.la_feltrinelli_books_api import Feltrinelli, Book, BestsellerEntry, DiscountType, BestsellerTimePeriod, BestsellerCategory
feltrinelli = Feltrinelli()
# Search for books by keyword
for book in feltrinelli.books.search(query="Dante Alighieri", limit=5):
print(book.title, book.author, book.price, book.ean)
# Browse discounted books using the DiscountType enum
for book in feltrinelli.books.discounted(promotion_type=DiscountType.PROMOZIONI, limit=3):
print(book.title, book.original_price, book.price, book.discount_percentage)
# Get bestsellers for this week
for entry in feltrinelli.bestsellerentries.list(category=BestsellerCategory.LIBRI, time_period=BestsellerTimePeriod.ONE_WEEK, limit=10):
print(entry.rank, entry.title, entry.author, entry.publisher)
# Fetch a specific book by EAN
detail = feltrinelli.books.get(ean="9788804671640")
print(detail.title, detail.authors, detail.publisher, detail.year, detail.availability)
Fetches new book releases from the last week on La Feltrinelli. Returns paginated results with book metadata including title, author, publisher, year, category, price, and availability. Pagination is 0-based. Each result includes an EAN usable with get_book_details for full info.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-based) |
| limit | integer | Max results per page |
{
"type": "object",
"fields": {
"total": "integer total number of matching books",
"results": "array of book objects"
},
"sample": {
"data": {
"total": 1219,
"results": [
{
"ean": "9788820084851",
"year": "2026",
"price": 17,
"title": "Game of Olympus. Catarsi",
"author": "Hazel Riley",
"authors": [
"Hazel Riley"
],
"category": "Narrativa italiana",
"publisher": "Sperling & Kupfer",
"product_url": "https://www.lafeltrinelli.it/game-of-olympus-catarsi-libro-hazel-riley/e/9788820084851",
"availability": "Disponibilità immediata",
"original_price": 17.9,
"discount_percentage": "5"
}
]
},
"status": "success"
}
}About the La Feltrinelli API
Catalog Discovery and Search
The search_books endpoint accepts a required query string plus optional page and limit parameters, returning a total count and a paginated results array. Each result includes title, author, authors (full array), publisher, year, category, price, original_price, discount_percentage, and availability. For more targeted lookups, advanced_search_books accepts separate title and/or author fields (at least one required) and filters results to books only, using 1-based pagination.
New Releases and Pre-orders
Three endpoints slice the catalog by recency: get_new_books_this_week, get_new_books_last_30_days, and get_new_books_last_90_days. All three return the same paginated book object shape. get_preorder_books returns upcoming releases available for pre-order, which is useful for tracking publication pipelines. None of these endpoints require a query string — they reflect La Feltrinelli's editorial new-arrival and forthcoming feeds directly.
Bestsellers and Category Browsing
get_bestsellers returns an array of ranked books. Each object includes a rank integer, ean, price, product_url, and standard bibliographic fields. Two optional parameters, category (e.g. libri, ebook) and time_period (e.g. 1week, 1month), let you target specific charts. get_books_by_category accepts a required category string matching La Feltrinelli's department names (e.g. Narrativa italiana, Gialli, thriller, horror) and returns a paginated list of books within that section.
Pricing and Promotions
get_discounted_books exposes books currently on promotion, with an optional type parameter accepting Promozioni or Outlet to separate standard sales from clearance stock. Response objects include both price and original_price, so discount_percentage can be verified independently. For a single-item lookup, get_book_details accepts either a 13-digit ean or a product_url containing the /e/<ean> pattern and returns the full detail record including availability status.
The La Feltrinelli API is a managed, monitored endpoint for lafeltrinelli.it — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when lafeltrinelli.it changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official lafeltrinelli.it API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track weekly bestseller chart movements across
libriandebookcategories for Italian market trend analysis. - Monitor
priceandoriginal_pricechanges on specific EANs to build a book price-tracking tool. - Aggregate new Italian book releases using
get_new_books_last_30_daysfor a publishing industry newsletter. - Build a pre-order watchlist by polling
get_preorder_booksand alerting when titles become available. - Populate a book recommendation engine with category-filtered results from
get_books_by_category. - Compare
discount_percentageacrossPromozioniandOutlettypes to surface the deepest current deals. - Resolve bibliographic metadata (publisher, year, authors) for a given ISBN using
get_book_detailswith aneaninput.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does La Feltrinelli offer an official public developer API?+
What does get_bestsellers return, and how can I filter it by chart type?+
rank integer, ean, title, author, price, publisher, category, product_url, and availability. Two optional parameters control which chart is returned: category accepts slugs like libri or ebook, and time_period accepts values like 1week or 1month. Omitting both returns the default chart.Does the API return reader reviews or ratings for books?+
Is pagination consistent across all list endpoints?+
get_new_books_this_week, search_books, get_books_by_category, etc.) use 0-based page indexing. The exception is advanced_search_books, which uses 1-based page numbering. All paginated responses include a total field indicating the full result count.Does the API cover non-book products sold on La Feltrinelli, such as music, films, or toys?+
search_books endpoint searches across product types on the site but returns results in the same book object shape. You can fork this API on Parse and revise it to add endpoints targeting La Feltrinelli's music, film, or gift product sections.