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.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 5.2s.
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 }}