Aleph Libros APIalephlibros.com.ar ↗
Search and retrieve book data from Librerías El Aleph (alephlibros.com.ar), including ARS prices, installment plans, discounts, authors, and publishers.
What is the Aleph Libros API?
The Aleph Libros API provides access to the catalog of Librerías El Aleph, an Argentine bookstore, through 1 endpoint that returns up to 16 book records per page. The search_books endpoint accepts keyword queries, ARS price range filters, and sort options, returning fields like current price, installment plans, discount percentage, stock status, author, publisher, and product identifiers.
curl -X GET 'https://api.parse.bot/scraper/6eef2c9c-9538-4b6b-8a15-81fc81f40847/search_books?page=1&query=borges&sort_by=price-ascending&max_price=50000&min_price=5000' \ -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 alephlibros-com-ar-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.
"""Walkthrough: Librerías El Aleph book search — bounded, re-runnable."""
from parse_apis.alephlibros_com_ar_api import AlephLibros, SortOrder, InvalidInput
client = AlephLibros()
# Browse cheapest books matching a keyword, capped at 5 results.
for book in client.books.search(query="borges", sort_by=SortOrder.PRICE_ASC, limit=5):
print(book.name, f"${book.price} {book.currency}", f"by {book.author}")
# Drill into the first best-selling book to inspect stock and discount.
top_book = client.books.search(sort_by=SortOrder.BEST_SELLING, limit=1).first()
if top_book is not None:
print(top_book.name, "| stock:", top_book.stock, "| discount:", top_book.discount_percent)
print("URL:", top_book.url)
# Price-range filter: books between 5000 and 15000 ARS.
try:
for book in client.books.search(
query="historia", min_price="5000", max_price="15000", limit=3
):
print(book.name, book.price, book.brand)
except InvalidInput:
print("Invalid search parameters")
print("exercised: books.search (keyword, sort, price range, best-selling)")
Search books by keyword with optional price range filtering and sorting. Returns paginated results (up to ~16 per page) with comprehensive book data including pricing, installment payment plans, stock, discount information, author, publisher/brand, and product identifiers. When query is empty, returns the full catalog. Pagination is controlled by the page parameter; use total_results from the response to determine the number of available pages.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-indexed). |
| query | string | Search keyword. When omitted or empty, returns the full catalog. |
| sort_by | string | Sort order for results. |
| max_price | string | Maximum price filter in ARS (e.g. '50000'). Omit to not filter by maximum price. |
| min_price | string | Minimum price filter in ARS (e.g. '5000'). Omit to not filter by minimum price. |
{
"type": "object",
"fields": {
"page": "Current page number",
"query": "The search query used",
"sort_by": "The sort order applied",
"products": "Array of book objects with full details",
"total_results": "Total number of matching books across all pages, or null if unavailable",
"results_on_page": "Number of books returned on this page"
},
"sample": {
"data": {
"page": 1,
"query": "borges",
"sort_by": "price-ascending",
"products": [
{
"sku": "310737",
"url": "https://www.alephlibros.com.ar/productos/borges-a-contraluz1/",
"name": "Borges a contraluz",
"brand": "Emece",
"price": 9000,
"stock": 1169,
"author": "Estela Canto",
"currency": "ARS",
"available": true,
"image_url": "https://acdn-us.mitiendanube.com/stores/004/008/965/products/9789500442619-f6ec89d12de7223ad717259143074923-1024-1024.webp",
"weight_kg": "0.3",
"product_id": 229765707,
"variant_id": 1013109196,
"description": "Consegui hoy Borges a contraluz | Estela Canto De Emece, ISBN (978-XXX-XX-XXXX-9). Libro Recomendado en Librerias El Aleph | Envios a toda Arg.",
"installments": {
"Pago Nube": {
"6": {
"interest": 0,
"total_value": 9000,
"installment_value": 1500,
"without_interests": true
}
}
},
"compare_at_price": 10000,
"discount_percent": 10,
"promotional_price": null,
"has_promotional_price": true,
"price_with_payment_discount": "$8.100,00"
}
],
"total_results": 31,
"results_on_page": 15
},
"status": "success"
}
}About the Aleph Libros API
What the API Returns
The search_books endpoint queries the Librerías El Aleph catalog and returns paginated book data. Each product object in the products array includes pricing in Argentine pesos (ARS), installment payment plan details, discount information, stock availability, author name, publisher/brand, and product identifiers. The total_results field provides the total matching count across all pages when available.
Filtering and Sorting
Results can be narrowed using min_price and max_price parameters, both expressed as ARS string values (e.g. '5000' and '50000'). The sort_by parameter controls result ordering. Pagination is handled via the page parameter (1-indexed), with each page returning approximately 16 books. Omitting the query parameter returns the full catalog rather than a filtered subset.
Coverage and Scope
The API covers the publicly browsable El Aleph catalog, which includes books listed at alephlibros.com.ar/search/. Response fields reflect what is visible on the storefront: list price, sale price, installment plan breakdowns, discount percentage, stock status, and bibliographic metadata such as author and publisher. All prices are denominated in ARS and reflect the Argentine market.
The Aleph Libros API is a managed, monitored endpoint for alephlibros.com.ar — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when alephlibros.com.ar 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 alephlibros.com.ar 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 ARS price changes on specific titles or authors across the El Aleph catalog over time.
- Build a book price comparison tool for Argentine readers using the
min_priceandmax_pricefilters. - Aggregate installment plan data to help shoppers compare cuota options across titles.
- Identify discounted books by monitoring the discount fields returned in each product object.
- Populate a book recommendation widget filtered by publisher or author using
search_bookskeyword queries. - Monitor stock availability for specific titles to trigger restock alerts.
- Generate a browsable Argentine bookstore catalog sorted by price or other criteria using the
sort_byparameter.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does alephlibros.com.ar have an official developer API?+
What does each book object in the `products` array contain?+
results_on_page field tells you how many records were returned on the current page, and total_results gives the full match count when available.Are there any limitations on pagination or result count?+
total_results field can be null if the source does not expose a total count for that query. You should handle null gracefully when iterating pages. There is no documented maximum page depth, but deep pagination may return fewer results as the catalog boundary is reached.Does the API return individual book detail pages, such as ISBNs, full descriptions, or reader reviews?+
Can I filter results by category, genre, or language?+
search_books endpoint supports filtering by keyword, price range (min_price, max_price), and sort order. Genre, category, or language filters are not exposed as parameters. You can fork the API on Parse and revise it to add category-based browsing endpoints.