IndiaMart APIdir.indiamart.com ↗
Search IndiaMart B2B listings by city and category. Retrieve product specs, pricing, supplier GST numbers, IEC codes, and verification status via 3 endpoints.
What is the IndiaMart API?
The IndiaMart Directory API provides 3 endpoints for accessing B2B supplier and product data from dir.indiamart.com. Use search_listings to query any city-category combination and get paginated supplier summaries with pricing, then drill into individual records with get_product_details for specifications and images, or get_supplier_details for GST numbers, IEC codes, and business verification status.
curl -X GET 'https://api.parse.bot/scraper/7ada03a6-ee11-42f9-8c09-14c45da9d229/search_listings?city=ahmedabad&pages=1&category=ss-pipes' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace dir-indiamart-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: IndiaMart SDK — search suppliers, inspect products, verify vendors."""
from parse_apis.IndiaMart_Scraper_API import IndiaMart, NotFound
client = IndiaMart()
# Search for stainless steel pipe suppliers in Ahmedabad
for listing in client.listings.search(city="ahmedabad", category="ss-pipes", limit=5):
print(listing.product_name, listing.price_inr, listing.supplier_name, listing.location)
# Drill into the first listing's product details
listing = client.listings.search(city="coimbatore", category="led-lights", limit=1).first()
if listing:
product = client.products.get(url=listing.product_url)
print(product.product_name, product.price, product.currency)
if product.product_images:
print("Images:", len(product.product_images))
# Get supplier factsheet with typed error handling
if listing and listing.supplier_url:
try:
supplier = client.suppliers.get(url=listing.supplier_url)
print(supplier.nature_of_business, supplier.gst_number, supplier.ships_from)
except NotFound as exc:
print(f"Supplier not found: {exc}")
print("exercised: listings.search / products.get / suppliers.get")
Search for listings by category on the IndiaMart export directory. Returns product and supplier summary information for the specified product category, optionally scoped to a city. Each page returns up to ~10 listings from verified exporters. Deduplicates across pages by product URL.
| Param | Type | Description |
|---|---|---|
| cityrequired | string | City name slug used to scope the search results (e.g. ahmedabad, coimbatore, mumbai, delhi). |
| pages | integer | Number of pages to fetch. |
| categoryrequired | string | Category slug used as the search term (e.g. ss-pipes, epoxy-flooring-services, steel-pipes). Hyphens are converted to spaces for the search query. |
{
"type": "object",
"fields": {
"items": "array of listing objects with product_name, product_url, price_raw, price_inr, unit, supplier_name, supplier_url, location, supplier_rating, supplier_type, nature_of_business, years_in_business, gst_verified, contact_details"
},
"sample": {
"data": {
"items": [
{
"unit": "Piece",
"location": "USA, Nepal, Sri Lanka, Saudi Arabia, Bangladesh",
"price_inr": 400,
"price_raw": "₹400/Piece",
"product_url": "https://export.indiamart.com/products/?id=2859228478673",
"gst_verified": true,
"product_name": "SS 304 Seamless Pipes India",
"supplier_url": "https://export.indiamart.com/company/180258510",
"supplier_name": "Jayant Rajendra Metal",
"supplier_type": "Verified Exporter",
"contact_details": "Gated (Login Required)",
"supplier_rating": "4.9",
"years_in_business": "2",
"nature_of_business": [
"Retailer"
]
}
]
},
"status": "success"
}
}About the IndiaMart API
What the API Covers
The API targets IndiaMart's directory of Indian B2B suppliers and products. It covers three layers of data: category-level search results browseable by city and product category, individual product pages with structured specifications and images, and supplier profile pages with regulatory and business identity fields. All three endpoints return structured JSON without requiring you to manage directory navigation yourself.
search_listings Endpoint
search_listings takes a required city slug (e.g. ahmedabad, coimbatore, mumbai) and a required category slug (e.g. ss-pipes, epoxy-flooring-services). An optional pages integer controls how many result pages are fetched. Each item in the returned array includes product_name, product_url, price_raw, price_inr, unit, supplier_name, supplier_url, and location — enough to build a price comparison table or supplier shortlist without additional calls.
get_product_details and get_supplier_details
get_product_details accepts a full IndiaMart product URL and returns product_name, price, currency, product_description, product_images (array of URLs), and a specifications object of key-value pairs. get_supplier_details accepts a supplier profile URL and returns gst_number, gst_registration_date, iec (Import Export Code), nature_of_business, ships_from, rating, and supplier_type (verification status). These fields are particularly useful for due diligence workflows where you need to verify a supplier's legal identity before engaging.
Pagination and Scope
Pagination in search_listings is controlled by the pages parameter. Coverage is limited to suppliers and products indexed in IndiaMart's city-category directory structure; only data accessible via a public product or supplier URL is returned. Contact details beyond what appears on public profile pages are not exposed.
The IndiaMart API is a managed, monitored endpoint for dir.indiamart.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when dir.indiamart.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official dir.indiamart.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a price comparison tool for industrial materials by querying multiple
categoryslugs across Indian cities. - Automate supplier shortlisting by collecting
gst_numberandsupplier_typeverification status before vendor onboarding. - Monitor product listing prices in a specific category and city combination over time using
price_inrfromsearch_listings. - Enrich a procurement database with structured
specificationsandproduct_imagesfromget_product_details. - Validate Import Export eligibility by extracting
ieccodes from supplier profiles viaget_supplier_details. - Map B2B supplier density by city and category using
locationandsupplier_urlfields from 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 | 100 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 IndiaMart have an official developer API?+
What does get_supplier_details return beyond a company name?+
gst_number, gst_registration_date, iec (Import Export Code), nature_of_business, ships_from (registered address), rating, and supplier_type which reflects the supplier's verification tier on IndiaMart. Fields are returned as null when not present on the profile.Does the API return buyer reviews or product ratings?+
rating at the profile level but do not expose individual buyer reviews, review counts, or per-product ratings. You can fork the API on Parse and revise it to add an endpoint targeting review sections of product or supplier pages.Are contact details like phone numbers or email addresses included?+
How does pagination work in search_listings?+
pages parameter is optional and controls how many sequential result pages are fetched for a given city and category combination. Omitting it fetches the default first page. There is no cursor or offset parameter; pages are fetched sequentially starting from page one.