sirthelabel.com APIsirthelabel.com ↗
Access SIR. The Label product catalog, variant pricing, loyalty tier rules, and policy pages via 4 structured API endpoints. Search, filter, and retrieve fashion data.
curl -X GET 'https://api.parse.bot/scraper/6ee4f54b-8cbf-4955-8ea8-b775469a2ede/search_products' \ -H 'X-API-Key: $PARSE_API_KEY'
Search products on SIR. The Label using full-text search with faceted filtering and pagination. Returns matching products with pricing, availability, images, and facet breakdowns for further filtering.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search query text (e.g. 'dress', 'silk top', 'midi skirt'). |
| sort_field | string | Field to sort by. Accepts: relevance, ss_days_since_published, ga_unique_purchases, ss_price. |
| sort_direction | string | Sort direction. Accepts: asc, desc. |
| results_per_page | integer | Number of results per page. |
{
"type": "object",
"fields": {
"query": "string",
"facets": "array of facet objects with field, label, and values (each with value and count)",
"results": "array of product objects with id, handle, name, price, url, image_url, variant_color, available, tags, collection_handle",
"pagination": "object containing total_results, current_page, total_pages, per_page"
},
"sample": {
"query": "dress",
"facets": [
{
"field": "tags_colour",
"label": "Colour",
"values": [
{
"count": 36,
"value": "black"
}
]
}
],
"results": [
{
"id": "8222791204953",
"url": "/products/phillipa-shirt-dress-eira-midnight",
"msrp": "0",
"name": "Phillipa Shirt Dress",
"tags": "available, badge_New Arrivals, Dress, Silk",
"price": "490",
"handle": "phillipa-shirt-dress-eira-midnight",
"available": true,
"image_url": "https://cdn.shopify.com/s/files/1/0037/8925/8841/files/S96-SIR226-1037_PHILLIPA_SHIRT_DRESS_EIRA_MIDNIGHT-25905-Sir_The_Label-D2-0442_1080x.jpg?v=1779181927",
"variant_color": "Eira Midnight",
"collection_handle": [
"dresses",
"new-arrivals",
"silk-dresses"
]
}
],
"pagination": {
"per_page": 5,
"total_pages": 40,
"current_page": 1,
"total_results": 196
}
}
}About the sirthelabel.com API
The SIR. The Label API exposes 4 endpoints covering product search, full product detail, loyalty program configuration, and static help pages for the Australian fashion brand's US storefront. The search_products endpoint supports full-text queries with faceted filtering and pagination, returning per-product pricing, availability, and color variant data. get_product delivers complete variant-level inventory, option sets, and description HTML for any product handle.
Product Search and Catalog
The search_products endpoint accepts a required query string (e.g. 'silk top', 'midi skirt') alongside optional parameters for sort_field (choose from relevance, ss_days_since_published, ga_unique_purchases, or ss_price), sort_direction, page, and results_per_page. Each result in the results array includes id, handle, name, price, url, image_url, variant_color, available, tags, and collection_handle. The facets array breaks down filterable dimensions with per-value counts, and the pagination object reports total_results, current_page, total_pages, and per_page.
Product Detail
get_product takes a handle string — the URL slug returned in search_products results — and returns the full product record. Response fields include title, description, images, options (name and values arrays), variants (each with id, sku, title, available_for_sale, quantity_available, price, currency, and compare_at_price), price_range (min/max with currency), and featured_image with src, width, height, and altText. This is sufficient to render a complete product page with size/color selectors and stock status.
Loyalty Program and Policy Pages
get_loyalty_program returns the public configuration of SIR.'s loyalty scheme: tiers (each with id, name, position, and point bounds), earning_rules (with kind, value, title, and enabled status), referral_incentive details, and settings covering point expiry behavior and birthday collection. An optional country parameter localizes the currency info. The get_page endpoint retrieves help and policy content by handle — known slugs include shipping-delivery, privacy-policy, terms-conditions, and contact-us — returning title, body_html, and a body_summary plain-text excerpt.
- Build a product feed for SIR. The Label items filtered by collection or color variant using
search_productsfacets. - Display real-time stock and size availability by fetching
quantity_availableper variant fromget_product. - Compare sale pricing by reading
compare_at_priceagainstpriceacross returned variants. - Render loyalty tier thresholds and point-earning rules in a customer-facing rewards explainer using
get_loyalty_program. - Pull structured shipping and returns policy text via
get_pagewith theshipping-deliveryorterms-conditionshandle. - Monitor new arrivals by sorting
search_productsresults byss_days_since_publisheddescending. - Build a referral program summary widget using the
referral_incentivefields fromget_loyalty_program.
| 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 SIR. The Label have an official public developer API?+
What does `search_products` return beyond basic product names and prices?+
variant_color, available status, tags, collection_handle, and an image_url, alongside the handle needed to fetch full details. The facets array provides field-level breakdowns with value counts you can use to build filter UIs without a separate facet query.Does `get_product` include sold-out variant information, or only available variants?+
variants array includes all variants regardless of availability. Each variant carries an available_for_sale boolean and a quantity_available integer, so sold-out sizes and colors are present in the response and can be identified programmatically.Are customer reviews or order history accessible through this API?+
Does the API cover the Australian storefront or only the US site?+
get_loyalty_program endpoint accepts a country parameter for currency localization, but product data and pagination reflect the US regional catalog. Coverage of the AU storefront is not currently included. You can fork the API on Parse and revise it to point at the AU domain.