# Meesho Scraper - Products, Prices & Ratings (`goat255/meesho-scraper`) Actor Search Meesho and get one clean row per product: price, rating with the full star breakdown, category, supplier state, delivery badges and specs. No login and no API key. - **URL**: https://apify.com/goat255/meesho-scraper.md - **Developed by:** [Goutam Soni](https://apify.com/goat255) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 product scrapeds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Meesho Scraper Search Meesho and get one clean row per product. Price, rating with the full star breakdown, category, supplier state, delivery badges and specs. No login and no API key. ### What it does - **Price as a number** in rupees, alongside the offer text shown on the listing, so you can sort and compare instead of parsing strings. - **Ratings done properly**: the average, the number of ratings, the number of written reviews, and the full one-to-five star breakdown where the source publishes it. - **Specs as structured fields**, so fabric, pattern, sleeve length and the rest arrive ready to filter instead of buried in a text blob. - **Supplier state on every row**, which is how you see where a category is actually manufactured. - **Deduplicated across every search term**, so a product matching two terms is delivered once and charged once. - **Filters** for minimum rating and maximum price. Common uses: price and assortment research, competitor and category tracking, sourcing and supplier-region analysis, building a product dataset, and monitoring how a category's pricing moves over time. ### Input | Field | Type | Description | |---|---|---| | `searchTerms` | array | Products, categories or keywords. One search per entry. | | `maxResultsPerTerm` | integer | Cap per term. Default 100. | | `minRating` | integer | Only products rated at least this (1 to 5). | | `maxPrice` | integer | Only products at or below this price, in rupees. | | `proxyConfiguration` | object | Optional. Enable to spread requests across IPs. | #### Example input ```json { "searchTerms": ["kurti", "running shoes"], "maxResultsPerTerm": 500, "minRating": 4, "maxPrice": 1500 } ```` ### Output Each item is one product listing. ```json { "productId": "0abcde", "catalogId": 100000001, "name": "Example Cotton Kurti", "description": "Example Cotton Kurti", "price": 245.0, "productPrice": 245.0, "currency": "INR", "hasMrp": true, "offerText": "₹215 with 2 Special Offers", "rating": 4.0, "ratingCount": 6809, "reviewCount": 141, "ratingBreakdown": { "1": 569, "2": 279, "3": 957, "4": 1744, "5": 3260 }, "category": "Kurtis & Kurtas", "categoryId": 1001, "isAssured": false, "isMallVerified": false, "isPopular": false, "tags": ["NEXT DAY DISPATCH"], "designCount": 4, "supplierStateCode": "RJ", "shippingCharges": 0.0, "isExpressDelivery": false, "specs": { "Fabric": "Rayon", "Sleeve Length": "Three-Quarter Sleeves", "Pattern": "Embroidered" }, "attributes": ["Fabric: Rayon"], "imageUrl": "https://example.com/cover.jpg", "images": ["https://example.com/photo-1.jpg"], "listedAt": "2024-01-21T13:29:06+05:30", "url": "https://www.meesho.com/s/p/0abcde", "searchTerm": "kurti" } ``` ### Notes - **A search stops when it runs out.** Ask for 500 products on a narrow term and you will get however many exist, not 500 padded rows. The run log states the count and the number of requests it took. - `rating` is the average that matches the published star counts. Products with no ratings yet return `null` rather than a zero, which would read as a bad score rather than no score. - `ratingBreakdown` is only published for some products. Those rows still carry `rating` and `ratingCount`, and return an empty breakdown rather than a guessed one. - `shippingCharges` of `0` means free delivery, which is the common case. It is a real zero, not a missing value. - `specs` is parsed from the listing's own detail block. Size lists are left in `attributes` and the detail text rather than forced into the spec shape, because they are listed per size and do not fit a label-and-value pair. - `price` is the catalog's starting price. Listings often span several designs and sizes at different prices, and `designCount` tells you how many are in the catalog. - `supplierStateCode` is the Indian state code the seller ships from, for example `GJ` or `RJ`. **Found this useful?** [Leave a quick review](https://apify.com/goat255/meesho-scraper/reviews). It takes a few seconds and it genuinely helps other people find the actor. ### Privacy To improve our actors we collect anonymized usage telemetry (run stats and input patterns). No personal account data is collected. # Actor input Schema ## `searchTerms` (type: `array`): Products, categories or keywords. One search per entry. Results are deduplicated across all terms. ## `maxResultsPerTerm` (type: `integer`): Cap per search term. A search that runs out of products returns everything available and stops, rather than padding to the cap. ## `minRating` (type: `integer`): Only products rated at least this. Unrated products are excluded when this is set. ## `maxPrice` (type: `integer`): Only products at or below this price. ## `proxyConfiguration` (type: `object`): Residential proxy is required for this source and is enabled by default. Leaving it on is recommended. ## Actor input object example ```json { "searchTerms": [ "kurti" ], "maxResultsPerTerm": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } } ``` # Actor output Schema ## `records` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerms": [ "kurti" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } }; // Run the Actor and wait for it to finish const run = await client.actor("goat255/meesho-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerms": ["kurti"], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "IN", }, } # Run the Actor and wait for it to finish run = client.actor("goat255/meesho-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "kurti" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } }' | apify call goat255/meesho-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=goat255/meesho-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Meesho Scraper - Products, Prices & Ratings", "description": "Search Meesho and get one clean row per product: price, rating with the full star breakdown, category, supplier state, delivery badges and specs. No login and no API key.", "version": "0.0", "x-build-id": "Nkdjcw5JrobRaGupB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/goat255~meesho-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-goat255-meesho-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/goat255~meesho-scraper/runs": { "post": { "operationId": "runs-sync-goat255-meesho-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/goat255~meesho-scraper/run-sync": { "post": { "operationId": "run-sync-goat255-meesho-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Products, categories or keywords. One search per entry. Results are deduplicated across all terms.", "default": [], "items": { "type": "string" } }, "maxResultsPerTerm": { "title": "Max products per term", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Cap per search term. A search that runs out of products returns everything available and stops, rather than padding to the cap.", "default": 100 }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only products rated at least this. Unrated products are excluded when this is set." }, "maxPrice": { "title": "Maximum price (INR)", "minimum": 1, "type": "integer", "description": "Only products at or below this price." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy is required for this source and is enabled by default. Leaving it on is recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```