Falabella APIfalabella.com ↗
Search and browse Falabella Chile's product catalog via API. Get prices, discounts, brand, and ratings for any query or category ID.
What is the Falabella API?
The Falabella Chile API provides 2 endpoints to search and browse products across falabella.com, returning up to 6 fields per product including current price, original price, discount percentage, brand, and ratings. Use search_products to run full-text queries against the entire catalog, or list_category_products to pull paginated listings from a specific category such as Cerraduras Digitales (CATG11151).
curl -X GET 'https://api.parse.bot/scraper/11a4dc2d-076d-4af5-bfce-075f7369af65/search_products?page=1&query=televisor&sort_by=derived.price.search%2Casc' \ -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 falabella-com-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: Falabella Chile product search and category browsing."""
from parse_apis.falabella_com_api import Falabella, SortBy, NotFoundError
client = Falabella()
# Search products by query, sorted by lowest price first
for product in client.product_catalogs.search(query="televisor", sort_by=SortBy.PRICE_ASC, limit=5):
print(product.name, product.brand, product.current_price, product.discount_percentage)
# Browse a specific category sorted by top rated
first_lock = client.product_catalogs.list_by_category(
category_id="CATG11151",
category_name="Cerraduras-Digitales",
sort_by=SortBy.TOP_RATED,
limit=1
).first()
if first_lock:
print(first_lock.name, first_lock.brand, first_lock.current_price, first_lock.original_price)
# Typed error handling for upstream failures
try:
for p in client.product_catalogs.list_by_category(category_id="CATG99999", limit=1):
print(p.name)
except NotFoundError as exc:
print(f"Category not found: {exc}")
print("exercised: product_catalogs.search / product_catalogs.list_by_category / NotFoundError")
Full-text search across the Falabella Chile product catalog. Returns paginated product listings matching the query, including current price, original price, discount percentage, brand, and ratings. Results are auto-iterated by the SDK.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| queryrequired | string | Search term to find products. |
| sort_by | string | Sort order for results. Omitted returns recommended order. |
{
"type": "object",
"fields": {
"per_page": "integer",
"products": "array of product objects",
"current_page": "integer",
"total_results": "integer"
},
"sample": {
"data": {
"per_page": 48,
"products": [
{
"url": "https://www.falabella.com/falabella-cl/product/152742967/smart-tv-55-tcl-4k-uhd-qled-55p7l",
"name": "Smart TV 55 QLED UHD 4K P7L",
"brand": "TCL",
"rating": "4.8462",
"product_id": "152742967",
"current_price": 309990,
"total_reviews": "13",
"original_price": 499990,
"currency_symbol": "CLP",
"discount_percentage": "-38%"
}
],
"current_page": 1,
"total_results": 342
},
"status": "success"
}
}About the Falabella API
Endpoints and What They Return
Both endpoints — search_products and list_category_products — return the same product object shape: products (array), total_results, current_page, and per_page. Each product includes the current price, original price, discount percentage, brand name, and customer rating. Pagination is 1-based; the SDK auto-iterates pages so you can walk the full result set without manually incrementing page.
Search vs. Category Browsing
search_products takes a required query string and runs full-text matching across the Falabella Chile catalog. An optional sort_by parameter controls result ordering; omitting it returns Falabella's default recommended order. list_category_products requires a category_id (e.g. CATG11151) and accepts an optional category_name for URL path resolution — when omitted it defaults to products. Both endpoints share the same optional sort_by and page parameters.
Coverage and Scope
This API covers the Falabella Chile storefront (falabella.com/falabella-cl). Prices reflect what is displayed on the Chilean site, including any active promotional discounts. Category IDs follow Falabella's internal taxonomy; you need a valid category_id to use list_category_products, which you can identify from category URLs on the Falabella Chile site.
Pagination Behavior
Both endpoints return total_results and per_page alongside current_page, so you can calculate the total page count and decide how deep to paginate. The SDK's auto-iteration handles sequential page requests, but you can also step through pages manually by passing an explicit page integer.
The Falabella API is a managed, monitored endpoint for falabella.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when falabella.com 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 falabella.com 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 price drops and discount percentages across a product category over time.
- Build a price comparison tool that queries Falabella Chile alongside other retailers.
- Monitor competitor brand listings within a specific Falabella category using
list_category_products. - Aggregate top-rated products in a category by filtering on the ratings field.
- Feed a product catalog feed with current prices and original prices for affiliate marketing.
- Alert users when a searched product's discount percentage crosses a defined threshold.
- Collect structured product data for market research on pricing trends in Chilean e-commerce.
| 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 Falabella have an official public developer API?+
What does `search_products` return beyond the product name and price?+
search_products returns a products array where each object includes the current price, original price, discount percentage, brand, and customer rating, along with pagination metadata: total_results, current_page, and per_page.Does the API cover Falabella storefronts in other countries like Peru or Colombia?+
falabella.com/falabella-cl). You can fork this API on Parse and revise it to point at a different country's Falabella subdomain.Does the API return product reviews or individual review text?+
How do I find the right `category_id` for `list_category_products`?+
/falabella-cl/category/CATG11151/Cerraduras-Digitales gives you the ID CATG11151. Pass that string as category_id. The optional category_name parameter corresponds to the slug after the ID in the URL.