falabella.com APIwww.falabella.com ↗
Search and browse Falabella Chile's product catalog via API. Get prices, discounts, brand, and ratings for any query or category ID.
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.com 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).
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.com API is a managed, monitored endpoint for www.falabella.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when www.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 www.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 | 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 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.