Stylishop APIstylishop.com ↗
Access Styli fashion catalog via API: products, categories, brands, reviews, size guides, search autocomplete, and trending data from stylishop.com.
What is the Stylishop API?
The Styli API covers 13 endpoints for browsing and querying the stylishop.com fashion catalog, including product listings, brand directories, customer reviews, and size guides. With get_product_details you can retrieve SKU-level data such as images, pricing, and attributes, while list_products supports pagination and sorting by popularity, price, or recency across any category context.
curl -X GET 'https://api.parse.bot/scraper/93481231-d9bf-4e48-a677-d31e21ee3cb0/get_homepage?lang=en' \ -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 stylishop-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.
"""
Styli Fashion API - SDK Usage Example
Get your API key from: https://parse.bot/settings
"""
from parse_apis.styli_fashion_api import Styli, Language, Sort, ProductNotFound
# Initialize the client
styli = Styli(api_key="YOUR_API_KEY")
# Browse new arrivals
for product in styli.products.new_arrivals(limit=5):
print(product.name, product.brand, product.sku)
# Search for dresses sorted by price
for product in styli.products.by_context(context_slug="spring-edit-w", sort_by=Sort.PRICE_ASC, limit=3):
print(product.name, product.brand)
# Search products by keyword
for product in styli.products.search(query="dress", limit=3):
print(product.name, product.sku, product.brand)
# Get product details by SKU
details = styli.products.get(sku="7026898024")
print(details.name, details.brand, details.sku)
# Get reviews for a product
review = details.reviews.get()
print(review.total_ratings, review.avg_ratings)
# Get size guide for a product
guide = details.size_guide.get()
print(guide.scale_en)
# List brands and browse one brand's products
for brand in styli.brands.list(limit=5):
print(brand.name, brand.count)
# Browse products from a specific brand
for product in styli.brand("Styli").products(limit=3):
print(product.name, product.sku)
# Get sale products
for product in styli.products.on_sale(limit=3):
print(product.name, product.discount_percentage)
# Browse categories in Arabic
for cat in styli.categories.list(lang=Language.AR, limit=3):
print(cat.title, cat.id)
# Get autocomplete suggestions
for suggestion in styli.suggestions.autocomplete(query="dress"):
print(suggestion.suggestion, suggestion.parent_category)
# Get trending searches by country
for trend in styli.trendingsearches.list():
print(trend.country, trend.en)
# Browse homepage sections
for section in styli.homepagesections.list(lang=Language.EN):
print(section.title, section.id)
Get homepage content including banners, promotions, and featured sections. Returns sections for Women, Men, and Kids with banner carousels, product grids, and promotional widgets.
| Param | Type | Description |
|---|---|---|
| lang | string | Language code. Accepted values: 'en', 'ar'. |
{
"type": "object",
"fields": {
"items": "array of homepage section objects with id, title, pageUniqueId, and rows"
},
"sample": {
"data": {
"items": [
{
"id": 1,
"rows": [
{
"id": 71870,
"name": "EN-KSA-Delivery-Strip-Common",
"rowType": "BannerCarousel"
}
],
"title": "WOMEN",
"pageUniqueId": "en_list_women"
}
]
},
"status": "success"
}
}About the Stylishop API
Product and Category Data
list_products accepts a required context_slug parameter (e.g. 'new-arrivals-w') and optional page, page_size, and sort_by inputs. The sort_by field accepts 'popularity', 'price_asc', 'price_desc', and 'new_arrivals'. The response object includes a products array, filters, totalCount, and pagination info. get_product_details returns per-SKU data: name, brand, images (with media gallery URLs), and a prices object containing both price and specialPrice for sale detection. list_categories returns the full navigation tree as tabs with nested category IDs and titles, available in English or Arabic via the lang parameter.
Search and Discovery
search_products accepts a query string and optional page and page_size inputs, returning the same paginated response shape as list_products. get_autocomplete takes a query prefix and returns an array of suggestion objects, each with a suggestion, flow, and parent_category — useful for building typeahead UIs. get_trending_searches requires no inputs and returns an array of current trending search term objects reflecting real-time popularity on the site.
Brands, Sales, and Reviews
list_brands returns a total count alongside a brands array where each object carries a brand name and product count. get_brand_products accepts a brand_name plus pagination parameters to retrieve that brand's full paginated product listing. get_sale_products and get_new_arrivals both follow the same paginated response structure. get_product_reviews takes a sku and returns a response object with totalRatings, avgRatings, fitDetails, and fitInsights — structured fit feedback rather than free-text reviews.
Size Guides and Homepage
get_size_guide accepts a product sku and returns a response object containing a size chart with sizes, scale, and preview images. This is resolved per-product, so chart data reflects the product's brand and category. get_homepage returns structured page content including rows (section arrays with banners and featured segments) and a pageUniqueId, also supporting the lang parameter for Arabic or English responses.
The Stylishop API is a managed, monitored endpoint for stylishop.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when stylishop.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 stylishop.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 using
get_product_detailsto trackpriceandspecialPriceacross SKUs over time. - Populate a fashion search interface using
search_productsandget_autocompletefor live query suggestions. - Generate brand-level product catalogs by combining
list_brandscounts withget_brand_productspagination. - Monitor new inventory by polling
get_new_arrivalsand diffingtotalCountagainst previous snapshots. - Display sale alerts by filtering
get_sale_productsresults wherespecialPriceis below a target threshold. - Integrate fit guidance into a shopping app using
get_size_guidefor SKU-specific size chart data. - Analyze trending queries and autocomplete flows from
get_trending_searchesandget_autocompleteto study on-site search behavior.
| 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 Styli (stylishop.com) offer an official developer API?+
What does `get_product_reviews` actually return — are individual review texts included?+
totalRatings, avgRatings, fitDetails, and fitInsights. Individual review text bodies are not part of the current response shape. You can fork this API on Parse and revise it to add an endpoint targeting individual review content if that data becomes accessible.Does the API support filtering `list_products` by size, color, or other attributes?+
list_products response includes a filters object describing available filter facets, but the endpoint inputs currently only accept context_slug, sort_by, page, and page_size. Passing attribute-based filter parameters is not supported in the current spec. You can fork the API on Parse and revise it to add filter input parameters to the listing endpoints.Are both Arabic and English content available from all endpoints?+
lang parameter accepting 'en' or 'ar' is available on get_homepage and list_categories. Other endpoints such as list_products, get_product_details, and get_product_reviews do not expose a lang input in the current spec, so language handling for those responses is fixed. You can fork this API on Parse and revise those endpoints to add language support.