Linio APIlinio.com ↗
Search Linio/Falabella Colombia products and retrieve pricing, variants, stock, specifications, and images via two structured endpoints.
What is the Linio API?
The Linio/Falabella Colombia API exposes 2 endpoints — search and get_details — covering product discovery and full product detail retrieval from Colombia's Falabella marketplace. A single search call returns paginated results with up to 10 fields per product including brand, pricing, seller, availability, and ratings. get_details adds variant-level pricing, purchasability flags, specification arrays, and HTML descriptions for any product URL.
curl -X GET 'https://api.parse.bot/scraper/30123d1d-f490-457f-b005-bd656d3c1467/search?page=1&query=samsung' \ -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 linio-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: Linio Colombia SDK — search products and inspect details."""
from parse_apis.linio_colombia_product_api import Linio, ProductNotFound
client = Linio()
# Search for Samsung products — limit caps total items fetched across pages.
for product in client.productsummaries.search(query="samsung", limit=5):
print(product.name, product.brand, product.seller)
# Drill into the first result's full detail via navigation.
summary = client.productsummaries.search(query="laptop", limit=1).first()
if summary:
detail = summary.details()
print(detail.name, detail.brand, detail.is_out_of_stock)
for spec in detail.specifications[:3]:
print(spec.name, spec.value)
for variant in detail.variants[:2]:
print(variant.sku, variant.is_purchasable, variant.stock)
# Direct product lookup by ID with typed error handling.
try:
product = client.products.get(product_id="152109166")
print(product.name, product.brand, len(product.images))
except ProductNotFound as exc:
print(f"Product gone: {exc.product_id}")
print("exercised: productsummaries.search / summary.details / products.get")
Full-text search over Falabella Colombia's product catalog. Returns paginated product summaries with pricing, seller, rating, and availability metadata. Pagination is page-based; total_results is always returned but current page and total_pages may be null when the site omits them.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination, must be a positive integer. |
| queryrequired | string | Search keyword (e.g. 'samsung', 'laptop', 'audifonos') |
{
"type": "object",
"fields": {
"items": "array of product summary objects with id, sku, name, brand, prices, url, rating, reviews, seller, availability, and image",
"pagination": "object with current, total_pages, and total_results"
},
"sample": {
"data": {
"items": [
{
"id": "152109166",
"sku": "152109168",
"url": "https://www.falabella.com.co/falabella-co/product/152109166/celular-samsung-a17-5g-256gb-8gb-ss",
"name": "Celular A17 5G 256GB 8GB SS",
"brand": "SAMSUNG",
"image": "https://media.falabella.com.co/falabellaCO/152109168_01/public",
"prices": [
{
"type": "eventPrice",
"icons": "",
"label": "",
"price": [
"713.900"
],
"symbol": "$ ",
"crossed": false
},
{
"type": "normalPrice",
"icons": "",
"label": "",
"price": [
"1.400.000"
],
"symbol": "$ ",
"crossed": true
}
],
"rating": "2",
"seller": "STAR",
"reviews": "2",
"availability": {
"primeShipping": "",
"expressShipping": "",
"homeDeliveryShipping": "",
"internationalShipping": "",
"pickUpFromStoreShipping": ""
}
}
],
"pagination": {
"current": null,
"total_pages": null,
"total_results": 4283
}
},
"status": "success"
}
}About the Linio API
Search Endpoint
The search endpoint accepts a required query string (e.g., 'samsung', 'laptop') and an optional page integer for pagination. Each item in the items array includes id, sku, name, brand, prices, url, rating, reviews, seller, availability, and image. The pagination object returns current, total_pages, and total_results, giving you the data needed to walk through multi-page result sets programmatically.
Product Detail Endpoint
The get_details endpoint takes a full Falabella Colombia product page URL and returns a structured object with variants, specifications, images, description_html, and description_text. The variants array breaks down each SKU-level option with its own prices, is_purchasable flag, stock count, and offers. The specifications array contains named attribute pairs — useful for filtering or comparing technical details across products.
Data Shape and Coverage
Both endpoints reflect the public Falabella Colombia catalog. The is_out_of_stock boolean at the product level gives a quick availability check without parsing variant data. Prices and stock can differ across variants, so iterating the variants array in get_details is necessary for accurate per-option data. Products are scoped to the Falabella Colombia storefront; other Linio regional sites are not included.
The Linio API is a managed, monitored endpoint for linio.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when linio.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 linio.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?+
- Build a price comparison tool that tracks
priceschanges across product variants over time - Monitor
is_out_of_stockandstockfields across multiple SKUs for inventory alerts - Populate a product catalog with
specificationsarrays for faceted search or filtering - Aggregate
ratingandreviewscounts fromsearchresults to rank top-rated products in a category - Extract
sellerandoffersdata to compare third-party marketplace pricing for the same product - Generate structured product feeds using
description_textandimagesfor downstream content pipelines - Track
branddistribution across keyword search results for competitive market analysis in Colombia
| 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/Linio have an official developer API?+
What does the `variants` array in `get_details` actually contain?+
sku, a display name, a prices structure, an is_purchasable boolean, a stock count, and an offers array. This lets you distinguish, for example, different color or storage options of the same product and see which are currently purchasable versus out-of-stock.Does the API cover seller reviews, question-and-answer sections, or seller ratings separately from product ratings?+
rating and reviews counts in search results, and variant-level offers in get_details, but does not return individual review text, Q&A threads, or per-seller rating breakdowns. You can fork this API on Parse and revise it to add an endpoint targeting those data sections.Is pagination available on `search`, and are there any limits to be aware of?+
search endpoint accepts a page integer and returns a pagination object with current, total_pages, and total_results. The page parameter must be a positive integer. Results beyond the last page will return no items, so checking total_pages before iterating is recommended.