MouthShut search
Find products/brands on MouthShut by keyword.
The front door for turning a brand name into the product_id the other
endpoints take. Each hit carries its id, canonical URL, image, category,
average rating, recommendation percentage and vote count. 20 results per
page, with the reported total and page count.
Two things worth knowing about MouthShut's ranking. It is personalised to the
request's location, so paging through a large result set is only strictly
consistent within a single call, treat product_id as the identity, not the
position. And asking past the last page re-serves the last page rather than
returning nothing, which showing_from/showing_to in the response make
visible.
Authorization
ApiKeyAuth Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/mouthshut-search-v4" \ -H "Content-Type: application/json" \ -d '{ "query": "zudio" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "page": 1, "query": "zudio", "results": [ { "category": { "name": "Apparels", "url": "https://www.mouthshut.com/apparels-proid-925077682" }, "image": "https://image3.mouthshut.com/images/imagesp/s/926166735s.png", "name": "Zudio", "product_id": "926166735", "rating": 3.88, "rating_count": 828, "recommended_percent": 84, "url": "https://www.mouthshut.com/product-reviews/zudio-reviews-926166735" }, { "category": { "name": "Stores", "url": "https://www.mouthshut.com/stores-proid-925070261" }, "image": "https://image3.mouthshut.com/images/imagesp/s/926097515s.jpg", "name": "Zudio - Commercial Street - Bengaluru", "product_id": "926097515", "rating": 0, "rating_count": 0, "recommended_percent": 0, "url": "https://www.mouthshut.com/product-reviews/zudio-commercial-street-bengaluru-reviews-926097515" }, "… 1 more item in the full response" ], "results_per_page": 20, "returned": 3, "showing_from": 1, "showing_to": 3, "total_pages": 1, "total_results": 3 }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "mouthshut-search-v4", "billable": true, "duration_ms": 4662 }}