{ "openapi": "3.0.1", "info": { "title": "IndiaMART Supplier Data — GST, Legal Status, IEC & CIN", "description": "IndiaMART suppliers by category and city: legal status, GSTIN (check-digit validated), IEC, CIN, turnover and employee bands, rating and IndiaMART's PNS phone line. Proprietorships excluded by default (DPDP). Reads only robots-allowed pages.", "version": "0.1", "x-build-id": "nEyc4xamNI6BgjCIl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/foxlabs~indiamart-supplier-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-foxlabs-indiamart-supplier-data", "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/foxlabs~indiamart-supplier-data/runs": { "post": { "operationId": "runs-sync-foxlabs-indiamart-supplier-data", "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/foxlabs~indiamart-supplier-data/run-sync": { "post": { "operationId": "run-sync-foxlabs-indiamart-supplier-data", "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": [ "categories" ], "properties": { "categories": { "title": "IndiaMART categories", "type": "array", "description": "One or more IndiaMART product categories. Paste the category slug (`cnc-machines`, `industrial-valves`, `industrial-chemicals`, `cotton-yarn`), the category name (`CNC Machines`) or a full listing URL such as `https://dir.indiamart.com/impcat/cnc-machines.html` or `https://dir.indiamart.com/delhi/cnc-machines.html`. Each listing page gives up to 28 suppliers; add cities below to widen coverage.", "items": { "type": "string" } }, "cities": { "title": "Cities (optional)", "type": "array", "description": "City names such as `Ahmedabad`, `Coimbatore`, `Navi Mumbai`. When filled, the city-specific listing of each category is read instead of the all-India one (up to 28 suppliers per category and city). Leave empty for the all-India listing of each category.", "items": { "type": "string" } }, "includeProprietorships": { "title": "Include proprietorships", "type": "boolean", "description": "Off by default. A sole proprietorship's GST number embeds the owner's personal PAN, so under India's DPDP Act 2023 such records are personal data of an individual. Turn this on only if you have your own lawful basis for processing them. Companies, LLPs and partnership firms are always included; suppliers whose legal status cannot be confirmed are skipped unless their name ends in Limited / Pvt Ltd / LLP.", "default": false }, "maxResults": { "title": "Max suppliers", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Stop after this many supplier rows. With several cities, suppliers are taken from the listings in turn, so a cap still covers every city. Set to 0 for unlimited.", "default": 500 }, "requestDelayMs": { "title": "Pause between IndiaMART requests (ms)", "minimum": 1000, "maximum": 10000, "type": "integer", "description": "Politeness pace for everything IndiaMART serves (listing, storefront and product pages and the catalog sites it hosts for suppliers), shared by all workers; never below 1000 ms.", "default": 1000 }, "maxConcurrency": { "title": "Parallel workers", "minimum": 1, "maximum": 2, "type": "integer", "description": "How many suppliers are processed at the same time. Capped at 2; IndiaMART requests still share one pace.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Default: Apify Proxy, Residential group. When IndiaMART refuses a proxy IP (HTTP 403, or HTTP 429 after the back-off), the actor retries the same page from a fresh session — at most 3 sessions per page and 10 new sessions per run. In our tests IndiaMART accepted 10 of 12 residential sessions and refused 9 of 13 datacenter sessions. Compute and proxy traffic are included in the per-record price (a delivered supplier used about 99 KB of residential traffic in our platform run).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }