shopsy.in APIshopsy.in ↗
Access Shopsy.in product search, category browsing, product details, and homepage deals via a structured JSON API. Includes pricing, ratings, and seller data.
curl -X GET 'https://api.parse.bot/scraper/a2c8ce6d-fa32-4cf0-8e68-b4a832b95815/search_products?page=1&sort=relevance&query=shoes' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with pagination and sorting support. Returns a paginated list of product summaries including pricing, ratings, and availability.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sort | string | Sort option. Accepted values: relevance, popularity, price_low_to_high, price_high_to_low, newest_first |
| queryrequired | string | Search keyword |
{
"type": "object",
"fields": {
"has_more": "boolean indicating if more pages are available",
"products": "array of product summary objects with product_id, title, subtitle, brand, price, mrp, discount, rating, review_count, image_url, product_url, availability",
"total_results": "integer total number of matching products"
},
"sample": {
"data": {
"has_more": true,
"products": [
{
"mrp": 499,
"brand": "Glowlife",
"price": 199,
"title": "Glowlife Kcandy Running Shoes For Men",
"rating": 3.5,
"discount": 60,
"subtitle": "Black",
"image_url": "http://rukmini1.flixcart.com/image/{@width}/{@height}/xif0q/shopsy-shoe/6/r/v/10-sh-110-black-10-glowlife-black-original-imah3duxpzkwgjfp.jpeg?q={@quality}",
"product_id": "EOEGBAHZQTGBW9EA",
"product_url": "https://www.shopsy.in/glowlife-kcandy-running-walking-training-sports-shoes-casual-shoe-running-shoes-men/p/itm0b161eb6486ba?pid=EOEGBAHZQTGBW9EA",
"availability": "IN_STOCK",
"review_count": 2903
}
],
"total_results": 50000
},
"status": "success"
}
}About the shopsy.in API
The Shopsy.in API provides 4 endpoints covering product search, detailed product pages, category browsing, and homepage deal banners. The search_products endpoint returns paginated product summaries — including price, MRP, discount percentage, ratings, and review counts — for any search keyword. Together, the endpoints expose over 15 distinct response fields, making it practical to build price trackers, deal aggregators, or catalog tools on top of Shopsy inventory.
Search and Browse
The search_products endpoint accepts a required query string plus optional page and sort parameters. Supported sort values are relevance, popularity, price_low_to_high, price_high_to_low, and newest_first. Each result in the products array includes product_id, title, subtitle, brand, price, mrp, discount, rating, review_count, and image_url. The has_more boolean and total_results integer let you paginate through full result sets.
The browse_category endpoint works similarly but scopes results to a category. You pass a category_slug matching the URL path segment on Shopsy (for example, casual-footwear-men-online or graphic-tshirts). An optional sid parameter filters to a specific sub-category store ID, overriding slug-based selection. The response shape is identical to search: paginated products array, has_more, and total_results.
Product Details
The get_product_details endpoint takes a full Shopsy product page URL and returns a richer data set: title, subtitle, price and mrp in INR, discount, rating, review_count, a seller object containing seller name, seller rating, and seller review count, a category_path breadcrumb array, and a top_reviews array. The top_reviews and category_path fields may be empty depending on the product.
Homepage Deals
The get_homepage_deals endpoint requires no inputs and returns the current promotional banner widgets from the Shopsy homepage. Each item in the deals array contains renderableComponents with image URLs, navigation actions pointing to category pages, and tracking metadata. This is useful for monitoring active promotions or syncing a deal feed with Shopsy's current marketing campaigns.
- Build a price-drop tracker that monitors
priceandmrpchanges for specific Shopsy products over time. - Aggregate daily deal banners from
get_homepage_dealsinto a deals newsletter or Telegram bot. - Compare seller ratings across products using the
sellerobject returned byget_product_details. - Populate a product catalog filtered by category slug with
browse_categoryand itssidsub-category parameter. - Run keyword-based product searches sorted by
price_low_to_highto surface the cheapest options programmatically. - Extract
category_pathbreadcrumbs from product detail pages to classify and tag inventory in a custom database. - Calculate effective discount rates by comparing
priceandmrpfields across paginated search results.
| 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 Shopsy have an official developer API?+
What does the `get_product_details` endpoint return that `search_products` does not?+
get_product_details endpoint returns fields not present in search results: a seller object (seller name, rating, and review count), a category_path breadcrumb array, and a top_reviews array. It takes a full product page URL as input rather than a keyword.Does the API return product specifications or feature lists?+
get_product_details response covers pricing, seller info, ratings, reviews, and category breadcrumbs, but does not include a structured specifications table or feature bullet list. You can fork this API on Parse and revise it to add a specifications field if the underlying product page exposes that data.How does pagination work across the search and category endpoints?+
search_products and browse_category return a has_more boolean and a total_results integer. Pass an incrementing page integer to step through result sets. When has_more is false, you have reached the last page.Can I filter search results by price range or brand?+
search_products endpoint only supports filtering by query, page, and sort order. Price-range or brand filters are not exposed as parameters. You can fork this API on Parse and revise it to add those filter parameters if Shopsy surfaces them through its category or search navigation.