legami.com APIlegami.com ↗
Access Legami's product catalog, basket management, and boutique store locator via 7 structured endpoints. Search products, get SKU details, and find store locations.
curl -X GET 'https://api.parse.bot/scraper/b361a643-6954-4674-aa6c-b8fb51cc5df6/search_products?limit=5&query=notebook&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on legami.com. Returns paginated results with product details, refinements, and sorting options.
| Param | Type | Description |
|---|---|---|
| limit | integer | Max results per page. |
| queryrequired | string | Search keyword (e.g. 'notebook', 'penna') |
| offset | integer | Pagination offset (number of results to skip). |
{
"type": "object",
"fields": {
"count": "integer total number of matching products",
"pageSize": "integer number of results in this page",
"products": "array of product objects with id, productName, price, images, variationAttributes",
"productSort": "object with available sorting options",
"refinements": "array of available filter options (color, theme, etc.)",
"searchRedirect": "string redirect URL if the search triggers a redirect instead of results"
},
"sample": {
"data": {
"count": 95,
"pageSize": 5,
"products": [
{
"id": "GMYNOT0263",
"price": {
"sales": {
"value": 9.95,
"currency": "EUR",
"formatted": "€ 9,95"
}
},
"productName": "Taccuino a Righe con Copertina Morbida Monocolore - Chartreuse - My Notebook",
"productType": "variationGroup"
}
],
"productSort": {
"options": [
{
"id": "raccomandati",
"displayName": "Raccomandati"
}
]
},
"refinements": [
{
"values": [
{
"hitCount": 1,
"displayValue": "MAP"
}
],
"displayName": "Tema"
}
],
"searchKeywords": "notebook"
},
"status": "success"
}
}About the legami.com API
The Legami.com API covers 7 endpoints for searching the product catalog, fetching full SKU details, managing shopping baskets, and locating physical boutique stores. The search_products endpoint returns paginated product arrays alongside refinement filters and sort options, while get_product_details supports batch retrieval of multiple SKUs in a single call — making it straightforward to build product feeds or comparison tools against Legami's stationery and gift inventory.
Product Search and Discovery
The search_products endpoint accepts a query string (e.g. 'notebook' or 'penna') with optional limit and offset parameters for pagination. The response includes a count of total matching products, a products array with per-item id, productName, price, images, and variationAttributes, plus a refinements array listing available filters such as color and theme. A productSort object enumerates the available sort orders. If a query triggers an automatic redirect on the site, searchRedirect returns the target URL instead of a results list.
Product Detail and Category Lookup
get_product_details takes a product_id that can be a single SKU like 'GEP0074' or a comma-separated batch string like 'GEP0074,VSKA0001'. Each item in the returned data array includes name, pricePerUnit, variants, variationAttributes, images, descriptions, and ratings. The list_categories endpoint accepts an optional query and returns categorySuggestions (with a categories array and suggestedPhrases), productSuggestions, and brandSuggestions — useful for building autocomplete or navigation trees.
Basket and Cart Management
Three endpoints handle cart state. create_basket creates a new session basket and returns its basketId, currency (EUR), orderTotal, creationDate, and customerInfo. get_basket retrieves the current session's basket count. add_to_cart accepts a product_id (variant-level, e.g. 'VEP0074') and an optional quantity; it auto-creates a basket if none exists and returns the updated orderTotal and productSubTotal.
Store Locator
find_boutique returns a stores object keyed by country code (e.g. 'IT'), with each country further divided by region. Each store record includes id, name, address, city, phone, hours, and services. This makes it usable for store-finder UIs or geographic analysis of Legami's retail footprint without any additional filtering parameters.
- Build a product feed for Legami stationery and gifts using
search_productswith keyword and pagination parameters - Fetch full variant-level pricing and ratings for multiple SKUs in one call via the batch mode of
get_product_details - Power an autocomplete search UI using
list_categoriesto surface category and product suggestions as users type - Implement a cart workflow — create basket, add variants, and retrieve totals — using the three basket endpoints
- Render a store-finder map using country, region, address, and hours data from
find_boutique - Track price and variant changes across specific SKUs by polling
get_product_detailson a schedule - Filter Legami products by color or theme by reading the
refinementsarray fromsearch_productsresponses
| 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 | 250 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 Legami have an official public developer API?+
What does `get_product_details` return that `search_products` does not?+
search_products returns summary fields suitable for listing pages: productName, price, images, and variationAttributes. get_product_details adds pricePerUnit, full descriptions, ratings, and the complete variants array — data typically shown on a product detail page. It also supports batch retrieval via a comma-separated product_id string, so you can resolve multiple SKUs in one request.Are order history or user account details available through this API?+
Does `find_boutique` support filtering stores by country or city?+
stores response object. Client-side filtering by country or city is needed to narrow results. You can fork this API on Parse and revise it to add server-side filtering parameters.What currency does the basket and pricing data use?+
orderTotal, productSubTotal, and pricePerUnit — are denominated in EUR. The currency field in basket responses explicitly returns 'EUR'. Multi-currency support is not currently part of the API.