cropp.com APIcropp.com ↗
Access Cropp's clothing catalog via API. Search products, browse categories, get product details with stock and sizing, and retrieve active promotions.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/623f3705-ffac-47c7-9714-2917d2e5a75f/get_homepage' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve homepage data including active promotions, discount codes, and banner images.
No input parameters required.
{
"type": "object",
"fields": {
"url": "string, the homepage URL",
"title": "string, site title",
"banners": "array of objects each with an 'image' URL string",
"promotions": "array of objects each with 'code', 'text', and 'type' strings"
},
"sample": {
"data": {
"url": "https://www.cropp.com/hu/hu/",
"title": "Cropp Hungary",
"banners": [
{
"image": "https://media.cropp.com/media/i/j/e/714f26eda1-allheaderhot-dropweek18desktop.jpg?impolicy=banner"
}
],
"promotions": [
{
"code": "GET20",
"text": "-20% kedvezmény egyes termékekre legalább 3 termék vásárlása esetén 04.29 - 05.04",
"type": "STANDARD_COUPON"
}
]
},
"status": "success"
}
}About the cropp.com API
The Cropp API covers 6 endpoints that expose product search, category browsing, product details, and active promotions from cropp.com. The search_products endpoint accepts a keyword query with pagination and returns per-product fields including price, regular price, color, available sizes, and sale status. Together, the endpoints give programmatic access to the full Hungarian-market Cropp catalog without a browser session.
Product Search and Category Browsing
The search_products endpoint accepts a required query string (e.g. 'polo' or 'nadrág') along with optional page (0-indexed) and limit parameters. Each product object in the response includes id, name, sku, price, regular_price, currency, url, image, sizes, color, and an is_sale flag. The list_products_by_category endpoint mirrors this shape but filters by a fixed category_path — accepted values are 'noi' (Women), 'ferfi' (Men), 'learazas' (Sale), and 'utos-ujdonsag' (New arrivals). Both endpoints return a total count and a pages count alongside the product list, so you can walk through results page by page.
Product Details
get_product_details accepts either a product slug (e.g. 'polo-756cu-mlc') or a full product URL — the slug is directly available from the url field returned by search or category listing calls. The detail response adds fields not present in listing responses: a material string with fabric composition, a full images array of high-resolution URLs, and a sizes array where each entry carries name, in_stock, quantity, and a size-level sku. This is the only endpoint that exposes per-size stock quantity.
Promotions and Homepage Data
get_active_promotions returns a country code (HU) and an array of promotion objects, each with a code, text, and type. The same promotion data also appears inside get_homepage, which additionally returns the site title, a banners array of image URLs, and the homepage url. list_categories returns a static list of top-level category objects with name, id, and path, useful for constructing valid category_path values to pass to list_products_by_category.
- Monitor Cropp sale prices by comparing
priceagainstregular_priceacross paginated search results. - Build a size availability tracker using per-size
in_stockandquantityfields fromget_product_details. - Aggregate active discount codes from
get_active_promotionsinto a coupon notification service. - Sync the Women's or Men's catalog into a product database using
list_products_by_categorywith thenoiorferfipath. - Track new arrivals by polling
list_products_by_categorywithcategory_path: 'utos-ujdonsag'on a schedule. - Extract material composition strings from
get_product_detailsto filter products by fabric type. - Collect banner image URLs via
get_homepageto observe how the store's visual merchandising changes over time.
| 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 Cropp offer an official public developer API?+
What does `get_product_details` return that listing endpoints do not?+
get_product_details adds material (fabric composition), a full images array of high-resolution URLs, and per-size quantity and sku fields. The search and category listing endpoints return only a single image URL and a flat sizes array without stock quantities.What category paths does `list_products_by_category` accept?+
'noi' (Women), 'ferfi' (Men), 'learazas' (Sale), and 'utos-ujdonsag' (New arrivals). Sub-category filtering within those groups is not supported. You can fork this API on Parse and revise it to add sub-category path support if you need narrower catalog slices.Does the API return product reviews or ratings?+
Is the API limited to the Hungarian market?+
get_active_promotions returns a country code of HU, and category path values reflect the Hungarian-language store. Cross-market coverage for other Cropp regional storefronts is not currently included. You can fork this API on Parse and revise it to target a different regional domain if needed.