{ "openapi": "3.0.1", "info": { "title": "BusinessList.my Malaysia Business Directory Scraper", "description": "Scrape businesslist.my, Malaysia's verified online business directory with 280,000+ listings. Search by category and city to get business name, address, phone, category, website, rating, opening hours, and more.", "version": "1.0", "x-build-id": "PobU7ev6n5kZrJ2wK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~businesslist-my-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-businesslist-my-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/crawlerbros~businesslist-my-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-businesslist-my-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/crawlerbros~businesslist-my-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-businesslist-my-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": { "mode": { "title": "Mode", "enum": [ "search", "byUrl" ], "type": "string", "description": "search: browse listings by category and/or city. byUrl: fetch specific business profile URLs directly.", "default": "search" }, "searchQuery": { "title": "Keyword search (mode=search)", "type": "string", "description": "Free-text keyword search across business names, services and taglines (e.g. \"laksa\", \"web design\", \"car rental\"), searching directory-wide. Takes priority over Category when set -- Category/City are then ignored for filtering, though City still narrows a keyword search to that city.", "default": "" }, "category": { "title": "Category (mode=search)", "enum": [ "custom", "general-business", "advertising", "printing", "small-business", "general-office-services", "consultants", "marketing", "retail-services", "training", "secretarial-services", "human-resources", "health-and-safety", "overseas-business", "consulting", "market-research", "fire-safety-consultants", "sales-outsourcing", "dry-cleaning", "public-relations", "business-development", "b2b", "business-to-business", "waste-services", "recycling", "laundries", "storage-services", "tailors-and-alterations", "baby-sitters", "garbage-removal", "ac-repair-services", "pet-grooming", "cold-storage-services", "nanny-agency", "dog-walking", "membership-services", "housekeeping-service", "debt-collection-agencies", "warehousing", "computer-services", "communications", "information-technology", "computer-software", "web-development", "web-design", "software-applications", "software", "networking", "internet-service-providers", "online-content", "computer-consumables", "web-services", "web-hosting", "apps", "information-services", "computer-repair", "fintech-financial-technology", "seo", "cryptocurrency", "artificial-intelligence", "computer-training", "cloud-computing", "saas", "e-learning", "project-management", "machine-learning", "cyber-security", "ios", "edtech-educational-technology", "trading-platform", "software-engineering", "virtual-reality", "agtech-agricultural-technology", "augmented-reality", "digital-currency-mining", "3d-technology", "mail-services", "cybersecurity", "scanning-services", "fashion", "arts-and-crafts", "leisure", "sports", "photography", "film-television-and-video", "pubs-and-clubs", "music", "pets-and-animals", "bookmakers", "parties", "casinos", "hobbies", "social-network", "performing-arts", "gambling", "lifestyle-management", "event-services", "event-equipment", "weddings", "conferences", "financial-activity", "audit-and-accounting", "business-management-consulting", "investment-companies", "tax-consultants", "banks-credit-unions", "finances-legal-services", "insurance-companies", "leasing", "insurance-services", "asset-management", "crowdfunding", "banking-equipment", "personal-finance", "payroll-services", "funding-platform", "money-service-business", "pawnshops", "online-payment-service-provider", "investing", "stock-exchanges", "food-retailers", "restaurants", "cafes", "catering", "food-manufacturing", "catering-equipment", "wine-and-beer", "supermarket", "cookery", "take-aways", "food-distributors", "organic-products", "beauty-professionals", "health-care", "doctors-and-clinics", "beauty-products", "dentists", "medical-equipment", "fitness", "hairdressers", "nursing-and-care", "complementary-therapy", "massage-therapists", "pharmacies", "pregnancy-child-birth", "opticians", "wellness", "cosmetic-surgery", "mental-health-care", "vitamins-and-supplements", "personal-care", "mobility-aids", "anti-aging-care", "spirituality", "sewing-and-needlework", "lawyers", "legal-services", "solicitors", "wills-and-trusts", "manufacturing", "engineering", "industrial-equipment", "furniture-manufacturers", "farming", "steel-products", "industrial-services", "automotive", "electrical-service", "industrial-automation", "engineers", "industrial-supplies", "paper-products", "oilgas-companies-support-services", "water-treatment", "civil-engineering", "pumps-manufacturers", "energy-suppliers", "industrial-premises", "aerospace", "product-development", "science", "infrastructure", "carpentry", "solar-panels", "utilities", "disinfecting-services", "electrical-goods", "hardware-stores", "home-and-garden", "clothing-and-accessories", "gifts", "jewellery", "furniture", "textile", "mobile-phone-shops", "brand-name", "books", "kids", "optical-shop", "shopping-centres", "cigars-and-tobacco", "camping-and-outdoors", "department-stores", "shopping-music", "marketplace", "fishing-equipment", "general-shopping", "duty-free-shop", "gadgets", "online-shopping", "sporting-goods", "pet-shops", "outlets", "discount-stores", "travel-agents", "hotels", "tourist-information", "tour-operators", "apartments", "attractions", "guest-houses", "specialist-accommodation", "holiday-homes", "hotelmotel-equipment", "excursions", "sightseeing", "places-to-visit", "homestay", "translation-services", "tourism", "visa-agencies", "camping-and-caravans", "bed-and-breakfast", "recreation", "self-catering-accommodation", "cottages", "construction", "building-materials", "chemicals", "construction-services", "architectural-services", "aluminium-openings", "construction-equipment", "pest-control", "locksmiths", "stainless-steel", "decorators", "staircase-timber-handrail", "water-filters", "metals", "roofing", "wrought-iron", "gardeners", "tempered-glass-railing", "construction-training", "doors", "windows", "excavators", "plumbers", "stone", "handyman", "concrete", "fencing-and-fence-materials", "remodeling", "forestry", "glass-manufacturing", "landscaping", "glass", "lumber", "paving", "sandblasting", "vehicle-services", "logistics", "transport", "car-parts-and-accessories", "vehicle-sales", "transport-agents", "petrol-station", "car-rental", "shippingport-agent", "marine-services", "air-travel", "bicycles", "taxis", "driving-schools", "air-transport", "motorbikes", "vehicle-manufacturers", "haulage", "transportation", "package-shipping", "auto-insurance", "courier-services", "cargo-services", "auto-parts-newused", "auto-repair", "auto-services", "auto-dealers-newused", "auto-supplies", "electric-vehicle", "parking", "tire-dealers", "ports-and-harbours", "rail-transport", "limousines", "mechanics", "boats-and-boating", "bus-line", "aviation", "car-wash", "schools-malaysia", "education", "childrens-services", "colleges", "religion", "communities", "universities", "environmental-services", "nonprofit-organizations", "government", "business-education", "associations", "sustainability", "public-transport", "tutoring", "local-authorities", "funeral-directors", "child-daycare-services", "retirement", "charity", "kindergartens", "social-work-services", "voluntary-organisations", "group-homes", "after-school-programs", "advice-centres", "youth-organizations", "political", "organizations", "government-services", "counseling-services", "estate-agents", "interior-design", "security", "cleaning", "property-development", "renovation", "removals-and-relocation", "home-remodeling", "realtors", "property-consultants", "fire-safety-equipment", "letting-agents", "commercial-property", "property-management", "home-improvement", "rental-property", "warehouses", "online-property-listings", "apartment-rental", "building-maintenance", "vacation-rentals", "overseas-property", "buildings", "coworking-spaces", "auctions" ], "type": "string", "description": "Business category to browse. Ignored if Keyword search is set. Leave as \"Custom category\" and fill in Custom category below for a category not in this list, or leave both empty (with a City set) to browse all categories in that city.", "default": "restaurants" }, "customCategory": { "title": "Custom category (mode=search)", "type": "string", "description": "Free-text category slug override, e.g. \"solar-panels\". Used when Category is set to \"Custom category\" or left blank. Takes priority over the Category dropdown when non-empty.", "default": "" }, "city": { "title": "City (mode=search)", "enum": [ "", "alor-gajah", "alor-setar", "alor-star", "ampang", "ampang-jaya", "ayer-itam", "ayer-keroh", "ayer-molek", "ayer-tawar", "bagan-serai", "bahau", "balakong", "bandar-baru-bangi", "banting", "batu-caves", "bayan-lepas", "bintulu", "bukit-mertajam", "butterworth", "cheras", "cukai", "dungun", "georgetown", "gua-musang", "ipoh", "johor-bahru", "kajang", "kampar", "kangar", "kemaman", "keningau", "klang", "kluang", "kota-bharu", "kota-kinabalu", "kota-tinggi", "kuala-kangsar", "kuala-krai", "kuala-lipis", "kuala-lumpur", "kuala-perlis", "kuala-pilah", "kuala-selangor", "kuala-terengganu", "kuantan", "kuching", "kulai", "kulim", "labuan", "lahad-datu", "langkawi", "limbang", "lumut", "malacca", "melaka", "mentakab", "mersing", "miri", "muar", "nibong-tebal", "nilai", "pasir-gudang", "pasir-mas", "pekan", "penang", "perai", "petaling-jaya", "port-dickson", "port-klang", "puchong", "rawang", "sandakan", "segamat", "selangor", "senai", "seremban", "seri-kembangan", "shah-alam", "sibu", "simpang-rengam", "skudai", "subang-jaya", "sungai-buloh", "sungai-petani", "taiping", "tampin", "tanah-merah", "tangkak", "tanjong-malim", "tapah", "tawau", "teluk-intan", "temerloh", "ulu-tiram", "yong-peng" ], "type": "string", "description": "Malaysian city/town to browse. Leave as \"(none - all cities)\" for a nationwide category browse, or set a city with an empty Category to browse all categories in that city.", "default": "" }, "customCity": { "title": "Custom city (mode=search)", "type": "string", "description": "Free-text city slug override for a town not in the City dropdown, e.g. \"beaufort\". Takes priority over the City dropdown when non-empty.", "default": "" }, "businessUrls": { "title": "Business profile URLs (mode=byUrl)", "type": "array", "description": "One or more businesslist.my company profile URLs to fetch directly, e.g. https://www.businesslist.my/company/209832/ah-cheng-laksa", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sortBy": { "title": "Sort results by", "enum": [ "relevance", "rating", "reviews", "name" ], "type": "string", "description": "Client-side sort applied to the collected results before output (mode=search only).", "default": "relevance" }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only include businesses with an average rating of at least this many stars (0-5). Businesses with no rating are excluded when this is set above 0.", "default": 0 }, "minReviews": { "title": "Minimum review count", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only include businesses with at least this many reviews.", "default": 0 }, "verifiedOnly": { "title": "Verified listings only", "type": "boolean", "description": "Only include businesses carrying businesslist.my's \"Verified Listing\" badge.", "default": false }, "fetchDetails": { "title": "Fetch full business profile details", "type": "boolean", "description": "For mode=search, fetch each business's profile page for richer data (website, description, opening hours, exact geo-coordinates, registration date). Roughly doubles the number of requests and run time.", "default": false }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of business records to return.", "default": 20 } } }, "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 } } } } } } } } } }