{ "openapi": "3.0.1", "info": { "title": "Justdial Scraper — Indian Business Leads, Phones & E-mails", "description": "Justdial scraper: export Indian businesses from justdial.com by category and city — phone (Justdial virtual numbers flagged), WhatsApp, e-mail, website, address, pincode, GPS, rating, ratings count, categories, hours, year established. 10k+ per big city. No login. Not affiliated with Justdial.", "version": "1.0", "x-build-id": "Z0WQKxHiOkVAVb8iO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~justdial-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-justdial-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/logiover~justdial-scraper/runs": { "post": { "operationId": "runs-sync-logiover-justdial-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/logiover~justdial-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-justdial-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", "properties": { "categories": { "title": "Categories / keywords", "type": "array", "description": "What to look for, the way Justdial names it: Restaurants, Plumbers, Dentists, Chartered Accountants, Gyms, Packers And Movers, Car Repair… Justdial resolves the word to its own category itself. Every keyword is searched in every city.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Indian cities as Justdial spells them: Mumbai, Delhi, Bangalore, Hyderabad, Chennai, Kolkata, Pune, Ahmedabad, Jaipur, Surat, Lucknow… Common alternative spellings (Bengaluru, New Delhi, Gurugram) are translated automatically.", "items": { "type": "string" } }, "areas": { "title": "Localities (optional)", "type": "array", "description": "Search only these localities of each city, e.g. Andheri West, Bandra West, Koramangala, Connaught Place. Leave empty to search the whole city (with locality expansion below).", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Justdial URLs (optional)", "type": "array", "description": "Paste Justdial search pages (https://www.justdial.com/Mumbai/Restaurants/nct-10408936, also with -in-) and/or business pages (…_BZDET). Search pages are read like a category × city search; business pages return that business with its full card.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max businesses", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after this many unique businesses in total (all searches together). Justdial shows about 100 per list; with locality expansion a big city × category gives thousands.", "default": 1000 }, "includeDetails": { "title": "Include business cards (e-mail, website, WhatsApp, full address, hours)", "type": "boolean", "description": "Opens every business's Justdial card for the full postal address with state, e-mail address(es), website(s), WhatsApp number, opening hours for each day, year of establishment, business summary, services/amenities, all phone numbers and the categories it is also listed in. One extra call per business — turn off for the fastest list-only export (phone, address line, pincode, GPS, rating, reviews, categories stay).", "default": true }, "expandAreas": { "title": "Expand into localities", "type": "boolean", "description": "Justdial serves about 100 businesses per search. With this on, every locality the results reveal (Andheri West, Malad West, Thane West…) is searched too and duplicates are dropped by Justdial's id — this is how one city × category reaches thousands of businesses. Turn off to get only the city-wide top list.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Justdial refuses datacenter and direct traffic (HTTP 403 \"Access Denied\"). The Actor therefore always uses Apify Residential proxies (worldwide pool, with India in rotation — whichever answers better during the run). Set your own proxy URLs here only if you have residential proxies of your own.", "default": { "useApifyProxy": true } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }