Sticker Mule APIstickermule.com ↗
Search Sticker Mule's ~75 custom print products, get full product specs, and price exact size/quantity configs with list and discounted prices via 3 endpoints.
What is the Sticker Mule API?
The Sticker Mule API exposes 3 endpoints covering the full public product catalog for Sticker Mule's custom printed goods. Use search_products to browse or filter all ~75 products by name substring or category, get_product to retrieve sizes, quantities, materials, apparel colors, shipping details, and customer review data for a single product, and get_configuration_price to compute exact pricing for a given width, height, and quantity combination.
curl -X GET 'https://api.parse.bot/scraper/e0c90af4-fc6f-40ba-bfdd-e26d5ea8ec31/search_products?query=magnet' \ -H 'X-API-Key: $PARSE_API_KEY'
Lists Sticker Mule's public product catalog (about 75 products in one call) with optional filtering by a case-insensitive name substring and/or by category. One row per product, sorted by site popularity rank. Also returns the full category vocabulary (id and label) seen in the catalog so callers can discover valid category values. An empty products array with total 0 is a valid result when no product matches the filters. The permalink field is the identifier accepted by get_product and get_configuration_price.
| Param | Type | Description |
|---|---|---|
| query | string | Case-insensitive substring matched against the product name or permalink (one shape: magnet). Omitted = no name filter. |
| category | string | Category id (e.g. custom-acrylics) or category label as returned in categories[].id / categories[].name. Omitted = no category filter. An unknown category yields an empty result. |
{
"type": "object",
"fields": {
"total": "number of products returned after filtering",
"products": "array of catalog products: product_id (site product id used for pricing), permalink (slug accepted by get_product / get_configuration_price), name, categories[] (id, name), product_url, image_url, fixed_unit_price (number for fixed-price items, null when priced by size/quantity), is_stock_item, popularity_rank, released_at (YYYY-MM-DD)",
"categories": "array of all catalog categories (id, name) usable as the category filter",
"catalog_total": "number of products in the whole catalog before filtering"
},
"sample": {
"data": {
"total": 2,
"products": [
{
"name": "Custom magnets",
"image_url": "https://storage.googleapis.com/sm-content/core/products/products/cm/index",
"permalink": "custom-magnets",
"categories": [
{
"id": "custom-magnets",
"name": "Custom magnets"
}
],
"product_id": "cm",
"product_url": "https://www.stickermule.com/products/custom-magnets",
"released_at": "2016-04-01",
"is_stock_item": false,
"popularity_rank": 7,
"fixed_unit_price": null
},
{
"name": "Acrylic magnets",
"image_url": "https://storage.googleapis.com/sm-content/core/products/products/acrylic-magnets/index",
"permalink": "acrylic-magnets",
"categories": [
{
"id": "custom-acrylics",
"name": "Custom acrylics"
}
],
"product_id": "acrylic-magnets",
"product_url": "https://www.stickermule.com/products/acrylic-magnets",
"released_at": "2025-03-10",
"is_stock_item": false,
"popularity_rank": 37,
"fixed_unit_price": null
}
],
"categories": [
{
"id": "blanks",
"name": "Blanks"
},
{
"id": "custom-acrylics",
"name": "Custom acrylics"
},
{
"id": "custom-magnets",
"name": "Custom magnets"
}
],
"catalog_total": 75
},
"status": "success"
}
}About the Sticker Mule API
Product Catalog Search
The search_products endpoint returns the entire Sticker Mule product catalog in a single call — typically around 75 products sorted by site popularity. Results can be narrowed with a query parameter (case-insensitive substring matched against product name or permalink) and/or a category parameter accepting either a category id (e.g. custom-acrylics) or its label. Each row in the products array includes a product_id, a permalink used as the key for the other two endpoints, and category associations. The response also returns a categories array listing every available category id and name, which can be used directly as filter values.
Product Detail
Passing a permalink to get_product returns the full specification for that product: preset sizes (width, height, unit), custom size constraints in inches, standard quantities, minimum_quantity, maximum_quantity, and quantity_step. Apparel products include a colors array; non-apparel products return an empty array for that field. The response also surfaces reviews data (count, average rating, and would-order-again percentage), shipping info (free_shipping flag, shipping_charge, and a note), and a currency field that reflects whichever ISO currency code was passed in the optional currency parameter — USD and EUR are confirmed; unsupported codes are rejected.
Configuration Pricing
get_configuration_price takes a permalink, width and height in inches, and a quantity, and returns both the regular_price (site list price before any promotion) and the discounted price reflecting any currently active site-wide promotion. The response includes unit_price (discounted price divided by quantity), total_price (discounted price plus shipping when available), and a has_discount boolean indicating whether a discount is currently applied. The configuration field echoes back the exact width, height, unit, and quantity that were priced, making it straightforward to display or log the priced spec alongside the result.
The Sticker Mule API is a managed, monitored endpoint for stickermule.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when stickermule.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 stickermule.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 custom print cost estimator that calls
get_configuration_pricefor multiple size/quantity combos and displays unit prices side by side. - Populate a product comparison table using
get_productto pull preset sizes, quantities, and shipping info for each item. - Filter Sticker Mule's catalog by category (e.g.
custom-acrylics) viasearch_productsto surface relevant products for a niche merchandise store. - Track whether a site-wide promotion is active by monitoring the
has_discountfield andregular_pricevs. discounted price fromget_configuration_price. - Display customer review signals (rating, count, would-order-again percentage) from
get_producton an affiliate or comparison site. - Pull the full category vocabulary from
search_productsresponses to drive a dynamic filter UI without hardcoding category ids. - Retrieve apparel color options via the
colorsarray inget_productto show available variants before directing a user to the product page.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Sticker Mule have an official developer API?+
What does `get_configuration_price` return beyond a total price?+
regular_price (the list price before promotions), the discounted price after any active site-wide percentage promotion, unit_price (discounted price divided by quantity), total_price (discounted price plus shipping charge when published), and a has_discount boolean. The configuration object echoes the exact width, height, unit, and quantity that were priced.Can I retrieve order history, artwork files, or account-level data through this API?+
Does `get_product` return pagination, or are all details in one response?+
get_product. Similarly, search_products returns the full filtered catalog in a single call rather than across pages; the total and catalog_total fields tell you how many products are in the filtered result and the full catalog respectively.