{
  "data": {
    "id": "bshUv7y1n6PIEYOF9",
    "actId": "HvtF8H6llxQEpUjj0",
    "userId": "IYgBDiXtHOijAaUel",
    "startedAt": "2026-11-17T04:40:55.987Z",
    "finishedAt": "2026-11-17T04:41:10.454Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 14330,
      "runTimeSecs": 14.33,
      "computeUnits": 0.015922222222222223,
      "imageSizeBytes": 332802048
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Yello.ae Business Listings by Category & Emirate Input\",\n  \"description\": \"Search Yello UAE (yello.ae, the UAE's largest business directory with 224,000+ companies) by category and/or emirate/city, or fetch full business profiles by direct URL.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to fetch: search a category and/or city, or fetch full business profiles from direct yello.ae URLs.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"detail\"\n      ],\n      \"enumTitles\": [\n        \"Search by category & city\",\n        \"Fetch business profiles by URL\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"category\": {\n      \"title\": \"Category\",\n      \"type\": \"string\",\n      \"description\": \"Business category to search for. Pick a common category, or choose 'Custom category' and type your own below (mode=search). Leave 'No category filter' + set a city to browse all businesses in that city.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"custom\",\n        \"\",\n        \"others\",\n        \"trading\",\n        \"clothing-and-accessories\",\n        \"food-retailers\",\n        \"electrical-goods\",\n        \"building-materials\",\n        \"general-office-services\",\n        \"restaurants\",\n        \"advertising\",\n        \"small-business\",\n        \"vehicle-services\",\n        \"home-and-garden\",\n        \"construction-services\",\n        \"estate-agents\",\n        \"professional-services\",\n        \"jewellery\",\n        \"contractors\",\n        \"car-parts-and-accessories\",\n        \"gifts\",\n        \"logistics\",\n        \"industrial-equipment\",\n        \"beauty-products\",\n        \"building-maintenance\",\n        \"textile\",\n        \"transport-companies\",\n        \"furniture\",\n        \"overseas-business\",\n        \"doctors-and-clinics\",\n        \"chemicals\",\n        \"communications\",\n        \"car-rental\",\n        \"industrial-services\",\n        \"vehicle-sales\",\n        \"travel-agents\",\n        \"mobile-phone-shops\",\n        \"computer-software\",\n        \"handbagsleather-products\",\n        \"carpentryflooring\",\n        \"brokers\",\n        \"plumbing-sanitary\",\n        \"interior-design\",\n        \"metal-products\",\n        \"event-equipment\",\n        \"roofing-materials-accessories\",\n        \"web-development\",\n        \"financial-activity\",\n        \"hotels\",\n        \"computer-services\",\n        \"computer-equipment\",\n        \"business-management-consulting\",\n        \"construction-equipment\",\n        \"farming\",\n        \"online-content\",\n        \"retail-services\",\n        \"event-services\",\n        \"web-design\",\n        \"film-television-and-video\",\n        \"secretarial-services\",\n        \"procurement\",\n        \"human-resources\",\n        \"ships-boats\",\n        \"electrical-fitting\",\n        \"aluminium-openings\",\n        \"beauty-professionals\",\n        \"cleaning\",\n        \"marketing\",\n        \"cafes\",\n        \"information-technology\",\n        \"removals-and-relocation\",\n        \"oil-natural-gas\",\n        \"schools\",\n        \"tour-operators\",\n        \"arts-and-crafts\",\n        \"software\",\n        \"pharmacies\",\n        \"electromechanical-equipment-installation\",\n        \"architectural-services\",\n        \"supermarkets\",\n        \"chemicals-trading\",\n        \"security\",\n        \"medical-equipment\",\n        \"computer-hardware\",\n        \"banks-credit-unions\",\n        \"management-consultants\",\n        \"engineering\",\n        \"decoration-materialspartitions\",\n        \"industrial-supplies\",\n        \"kids\",\n        \"printing\",\n        \"education\",\n        \"consulting\",\n        \"audit-and-accounting\",\n        \"surveyors\",\n        \"property-management-services\",\n        \"investment-companies\",\n        \"engineers\",\n        \"marine-services\",\n        \"hardware-stores-in-emirates\",\n        \"handling-loadinglifting\",\n        \"web-services\",\n        \"networking\",\n        \"photography\",\n        \"dentists\",\n        \"buses-rental\",\n        \"real-estate-developers\",\n        \"hairdressers\",\n        \"sports\",\n        \"shopping-centres\",\n        \"auto-batteries\",\n        \"lawyers\"\n      ],\n      \"enumTitles\": [\n        \"Custom category (type below)\",\n        \"No category filter (browse city)\",\n        \"General Services\",\n        \"Trading\",\n        \"Clothing and Accessories\",\n        \"Food Retailers\",\n        \"Electrical Goods\",\n        \"Building Materials\",\n        \"General Office Services\",\n        \"Restaurants\",\n        \"Advertising\",\n        \"Small Business\",\n        \"Vehicle Services\",\n        \"Home and Garden\",\n        \"Construction Services\",\n        \"Real Estate Agents\",\n        \"Professional Services\",\n        \"Jewellery\",\n        \"Contractors\",\n        \"Car Parts and Accessories\",\n        \"Gifts\",\n        \"Logistics\",\n        \"Industrial Equipment\",\n        \"Beauty Products\",\n        \"Building Maintenance\",\n        \"Textile\",\n        \"Transport Companies\",\n        \"Furniture\",\n        \"Overseas Business\",\n        \"Doctors and Clinics\",\n        \"Chemicals\",\n        \"Communications\",\n        \"Car Rental\",\n        \"Industrial Services\",\n        \"Vehicle Sales\",\n        \"Travel Agents\",\n        \"Mobile Phone Shops\",\n        \"Computer Software\",\n        \"Handbags & Leather Products\",\n        \"Carpentry & Flooring\",\n        \"Brokers\",\n        \"Plumbing & Sanitary\",\n        \"Interior Design\",\n        \"Metal Products\",\n        \"Event Equipment\",\n        \"Roofing Materials & Accessories\",\n        \"Web Development\",\n        \"Financial Activity\",\n        \"Hotels\",\n        \"Computer Services\",\n        \"Computer Equipment\",\n        \"Business Management Consulting\",\n        \"Construction Equipment\",\n        \"Farming\",\n        \"Online Content\",\n        \"Retail Services\",\n        \"Event Services\",\n        \"Web Design\",\n        \"Film, Television and Video\",\n        \"Secretarial Services\",\n        \"Procurement\",\n        \"Human Resources\",\n        \"Ships & Boats\",\n        \"Electrical Fitting\",\n        \"Aluminium Openings\",\n        \"Beauty Professionals\",\n        \"Cleaning\",\n        \"Marketing\",\n        \"Cafes\",\n        \"Information Technology\",\n        \"Removals and Relocation\",\n        \"Oil & Natural Gas\",\n        \"Schools\",\n        \"Tour Operators\",\n        \"Arts and Crafts\",\n        \"Software\",\n        \"Pharmacies\",\n        \"Electromechanical Equipment Installation\",\n        \"Architectural Services\",\n        \"Supermarkets\",\n        \"Chemicals Trading\",\n        \"Security\",\n        \"Medical Equipment\",\n        \"Computer Hardware\",\n        \"Banks, Credit Unions\",\n        \"Management Consultants\",\n        \"Engineering\",\n        \"Decoration Materials & Partitions\",\n        \"Industrial Supplies\",\n        \"Kids\",\n        \"Printing\",\n        \"Education\",\n        \"Consulting\",\n        \"Audit and Accounting\",\n        \"Surveyors\",\n        \"Property Management Services\",\n        \"Investment Companies\",\n        \"Engineers\",\n        \"Marine Services\",\n        \"Hardware Stores\",\n        \"Handling, Loading & Lifting\",\n        \"Web Services\",\n        \"Networking\",\n        \"Photography\",\n        \"Dentists\",\n        \"Buses Rental\",\n        \"Real Estate Developers\",\n        \"Hairdressers\",\n        \"Sports\",\n        \"Shopping Centres\",\n        \"Auto Batteries\",\n        \"Lawyers\"\n      ],\n      \"default\": \"restaurants\",\n      \"prefill\": \"restaurants\"\n    },\n    \"customCategory\": {\n      \"title\": \"Custom category (overrides selection above)\",\n      \"type\": \"string\",\n      \"description\": \"Free-text category slug not in the curated list above, e.g. 'locksmiths' or 'it-services' (mode=search). Takes priority over 'Category' when set. Use the slug shown in a yello.ae category URL (lowercase, hyphenated).\",\n      \"editor\": \"textfield\"\n    },\n    \"city\": {\n      \"title\": \"Emirate / city\",\n      \"type\": \"string\",\n      \"description\": \"UAE emirate or city to search in. Combine with 'Category' to search a category within one city, or leave category empty to browse all businesses in the city (mode=search).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"dubai\",\n        \"abu-dhabi\",\n        \"sharjah\",\n        \"al-ain\",\n        \"ajman\",\n        \"ras-al-khaimah\",\n        \"jebel-ali-free-zone\",\n        \"fujairah\",\n        \"um-al-quwain\",\n        \"dibba\",\n        \"khor-fakkan\"\n      ],\n      \"enumTitles\": [\n        \"No city filter (nationwide)\",\n        \"Dubai\",\n        \"Abu Dhabi\",\n        \"Sharjah\",\n        \"Al Ain\",\n        \"Ajman\",\n        \"Ras Al Khaimah\",\n        \"Jebel Ali Free Zone (JAFZ)\",\n        \"Fujairah\",\n        \"Umm Al Quwain\",\n        \"Dibba\",\n        \"Khor Fakkan\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"dubai\"\n    },\n    \"customCity\": {\n      \"title\": \"Custom city (overrides selection above)\",\n      \"type\": \"string\",\n      \"description\": \"Free-text city slug not in the curated list above (mode=search). Takes priority over 'Emirate / city' when set.\",\n      \"editor\": \"textfield\"\n    },\n    \"sortBy\": {\n      \"title\": \"Sort order\",\n      \"type\": \"string\",\n      \"description\": \"How to order search results after fetching (mode=search). yello.ae itself only returns relevance order, so 'rating' and 'name' are applied client-side across the fetched batch.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"relevance\",\n        \"rating\",\n        \"name\"\n      ],\n      \"enumTitles\": [\n        \"Relevance (yello.ae's own order)\",\n        \"Rating (highest rated first)\",\n        \"Name (A-Z)\"\n      ],\n      \"default\": \"relevance\",\n      \"prefill\": \"relevance\"\n    },\n    \"verifiedOnly\": {\n      \"title\": \"Verified businesses only\",\n      \"type\": \"boolean\",\n      \"description\": \"Only return businesses with yello.ae's own 'Verified' badge (mode=search).\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"minRating\": {\n      \"title\": \"Minimum rating\",\n      \"type\": \"integer\",\n      \"description\": \"Only return businesses rated at least this many stars, e.g. 4 for 4.0+ (mode=search). 0 means no minimum. Businesses with no rating are excluded once this is set above 0.\",\n      \"minimum\": 0,\n      \"maximum\": 5,\n      \"default\": 0,\n      \"prefill\": 0\n    },\n    \"fetchDetails\": {\n      \"title\": \"Fetch full business profiles\",\n      \"type\": \"boolean\",\n      \"description\": \"For each search result, also visit its business profile page to collect full address, website, working hours, manager, establishment year, employee count, registration code, categories/tags, description, and photos. Slower -- one extra request per result (mode=search).\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"businessUrls\": {\n      \"title\": \"Business profile URLs (mode=detail)\",\n      \"type\": \"array\",\n      \"description\": \"Direct yello.ae business profile URLs to fetch, e.g. https://www.yello.ae/company/344843/cafe-torino. Use the 'sourceUrl' field from search results.\",\n      \"editor\": \"requestListSources\",\n      \"items\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"url\": {\n            \"title\": \"URL\",\n            \"type\": \"string\",\n            \"description\": \"yello.ae business profile URL.\"\n          }\n        }\n      },\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on the number of business records to return.\",\n      \"minimum\": 1,\n      \"maximum\": 1000,\n      \"default\": 20,\n      \"prefill\": 3\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Yello.ae Business Listings by Category & Emirate\r\n\r\nYello.ae is a large UAE business directory covering every emirate. This actor runs a category-and-city search against it or fetches specific business profile pages directly, returning names, addresses, phone numbers, ratings, and verification status for each — with an optional deeper pass for website, working hours, manager, establishment year, employee count, registration code, tags, description, and photos. No login, cookies, or API key required.\r\n\r\n## What this actor does\r\n\r\n- **Two modes:** `search` (category and/or city) and `detail` (direct business profile URLs)\r\n- **110 curated categories** to pick from, or type any custom category slug\r\n- **All 7 emirates plus 4 major sub-cities** available as a one-click filter (Dubai, Abu Dhabi, Sharjah, Al Ain, Ajman, Ras Al Khaimah, Jebel Ali Free Zone, Fujairah, Umm Al Quwain, Dibba, Khor Fakkan)\r\n- **Sort by** relevance, rating, or name (A-Z)\r\n- **Filter by** \"verified businesses only\" or minimum star rating (1-5)\r\n- **Rich business profiles** — full address, GPS coordinates, website (decoded from yello.ae's outbound tracking link), working hours, manager name, establishment year, employee-count bracket, registration code, listed categories, tags, description, photos, products/services, and individual written reviews\r\n- **Empty fields are omitted** — you only ever see fields that were actually found for a business\r\n\r\n## Output per business\r\n\r\n- `businessId` - yello.ae business id (search and detail)\r\n- `name` — business name\r\n- `category` — primary listed category, `categories[]` — all registered categories (when profile fetched)\r\n- `tags[]` — free-text keyword tags the business added (when profile fetched)\r\n- `rating`, `reviewCount` — average star rating (1-5) and total number of reviews\r\n- `address` — full address text (mode=search); `street`, `city`, `country` — structured address (when profile fetched)\r\n- `latitude`, `longitude` — GPS coordinates from the search-result map pin (mode=search); precise coordinates from the business profile (when profile fetched)\r\n- `verified` — yello.ae's own \"Verified\" badge status\r\n- `yearsWithUs` — years registered with yello.ae (also available from the search-result card, not only when profile fetched)\r\n- `establishedYear` — year the business itself was established\r\n- `photosCount` — number of photos on the business's yello.ae listing\r\n- `phone`, `mobilePhone`, `fax` — contact numbers (when profile fetched)\r\n- `website` — the business's own outbound website link, decoded from yello.ae's tracking redirect\r\n- `workingHours[]` — structured opening hours (`{day, hours}` per weekday; when profile fetched)\r\n- `manager` — company manager/owner name (when profile fetched)\r\n- `employeeCount` — employee-count bracket, e.g. `\"26-50\"` (when profile fetched)\r\n- `registrationCode` — business registration code (when profile fetched)\r\n- `description` — company description (when profile fetched)\r\n- `images[]`, `logoUrl` — business photos and logo (when profile fetched)\r\n- `products[]` — products/services listed on the profile (`{name, description, price, imageUrl}`; when profile fetched and the business has any)\r\n- `reviews[]` — individual written reviews (`{author, rating, title, text, date}`; when profile fetched and the business has any)\r\n- `lastUpdated`, `registeredOn` — profile last-updated and yello.ae registration timestamps (when profile fetched and the \"Verified Business\" panel is present)\r\n- `searchTotal` - total matching listings reported by Yello (mode=search)\r\n- `searchCategory`, `searchLocation` — the search parameters used (mode=search)\r\n- `sourceUrl` — canonical yello.ae profile URL for the business\r\n- `recordType: \"business\"`, `scrapedAt`\r\n\r\n## Input\r\n\r\n| Field | Type | Default | Description |\r\n|---|---|---|---|\r\n| `mode` | string (select) | `search` | `search` (category and/or city) or `detail` (fetch by URL) |\r\n| `category` | string (select) | `restaurants` | Pick a common category, or `custom` to use `customCategory`, or leave empty to browse by city only (mode=search) |\r\n| `customCategory` | string | – | Any free-text category slug, overrides `category` (mode=search) |\r\n| `city` | string (select) | – | Emirate/city to search in, or leave empty for nationwide (mode=search) |\r\n| `customCity` | string | – | Any free-text city slug, overrides `city` (mode=search) |\r\n| `sortBy` | string (select) | `relevance` | `relevance` / `rating` (highest first) / `name` (A-Z) — applied client-side across the fetched batch |\r\n| `verifiedOnly` | boolean | `false` | Only return businesses with yello.ae's \"Verified\" badge |\r\n| `minRating` | integer | `0` (no minimum) | Only return businesses rated at least 1-5 stars |\r\n| `fetchDetails` | boolean | `false` | Also visit each business's profile page for richer data (slower) |\r\n| `businessUrls` | array | – | yello.ae profile URLs to fetch directly (mode=detail) |\r\n| `maxItems` | int | `20` | Hard cap on returned records (1-1000) |\r\n\r\n### Example: search restaurants in Dubai\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"category\": \"restaurants\",\r\n  \"city\": \"dubai\",\r\n  \"maxItems\": 20\r\n}\r\n```\r\n\r\n### Example: highest-rated dentists in Abu Dhabi, with full profiles\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"category\": \"dentists\",\r\n  \"city\": \"abu-dhabi\",\r\n  \"sortBy\": \"rating\",\r\n  \"fetchDetails\": true,\r\n  \"maxItems\": 30\r\n}\r\n```\r\n\r\n### Example: verified 4+ star hotels across the whole UAE\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"category\": \"hotels\",\r\n  \"verifiedOnly\": true,\r\n  \"minRating\": 4,\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Example: all businesses in Sharjah (no category filter)\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"category\": \"\",\r\n  \"city\": \"sharjah\",\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Example: fetch specific business profiles\r\n\r\n```json\r\n{\r\n  \"mode\": \"detail\",\r\n  \"businessUrls\": [\r\n    { \"url\": \"https://www.yello.ae/company/344843/cafe-torino\" }\r\n  ]\r\n}\r\n```\r\n\r\n## Use cases\r\n\r\n- **Local lead generation** — build a prospect list of UAE businesses by trade and emirate for B2B outreach\r\n- **Market research** — measure business density and average ratings for a category across UAE regions\r\n- **Directory aggregation** — feed structured UAE business data into your own local-search product\r\n- **Competitor mapping** — see who else operates in a category and area, with ratings and contact info\r\n- **Franchise & site-selection analysis** — evaluate service-business coverage across emirates and cities\r\n\r\n## Limitations\r\n\r\n- **`sortBy` is applied client-side.** yello.ae's search-results pages don't expose a server-side sort parameter, so `rating`/`name` sorting is applied across the batch of records this run actually fetched, not the entire category.\r\n- **`verifiedOnly` and `minRating` are applied client-side.** A business with no rating on yello.ae is only excluded by `minRating` (which requires a rating to compare against).\r\n- **`website` reflects the business's own self-submitted link, as-is.** yello.ae stores this as an outbound tracking redirect which this actor decodes back to the real destination URL; the destination itself is whatever the business owner entered and is not validated by yello.ae or this actor (occasionally a business lists a social-media page instead of a proper website).\r\n- **E-mail addresses and WhatsApp numbers are not included.** yello.ae gates both behind its paid \"Data Hub\" product / a sign-in \"Send Enquiry\" form; they are not present in the publicly accessible HTML, so this actor cannot populate them.\r\n- **`reviews[]` and `products[]` are only available with `fetchDetails: true` (search mode) or `mode: detail`**, and only for businesses that have any — yello.ae's search-results cards only expose the aggregate `rating`/`reviewCount`, not individual review text or product listings; both live on the business profile page.\r\n\r\n## FAQ\r\n\r\n**What data source does this actor use?**\r\nIt reads the publicly available search and business-profile pages on yello.ae (note: this is `yello.ae`, not `yellow.ae`, which is an unrelated parked domain). No account or API key is needed.\r\n\r\n**Is this affiliated with yello.ae?**\r\nNo. This is an independent, third-party actor that reads publicly accessible pages.\r\n\r\n**Why do some businesses have no rating, phone, or website?**\r\nyello.ae only shows a rating once a business has received at least one review, and only shows contact/website details a business itself provided. Fields with no data are simply omitted from the record rather than shown as empty or null.\r\n\r\n**Can I search a whole emirate instead of a single city?**\r\nYes — every value in the `city` dropdown (Dubai, Abu Dhabi, Sharjah, Al Ain, Ajman, Ras Al Khaimah, Fujairah, Umm Al Quwain) is itself an emirate or a major city within one; Jebel Ali Free Zone, Dibba, and Khor Fakkan are additional sub-city areas yello.ae tracks separately.\r\n\r\n**Can I search all of the UAE at once?**\r\nYes — leave `city` empty (the default) for a nationwide search within a category.\r\n\r\n**How accurate are the GPS coordinates?**\r\nIn `search` mode, `latitude`/`longitude` come from the same map-pin coordinates yello.ae shows on the search-results card, so they're present without needing `fetchDetails`. With `fetchDetails: true` or in `detail` mode, they're replaced by the more precise coordinates from the business's own profile page.\r\n\r\n**Why is `fetchDetails` off by default?**\r\nFetching each business's full profile page requires one extra request per result, which is slower. Turn it on when you need website, working hours, manager, establishment year, employee count, registration code, categories/tags, description, photos, products/services, or individual reviews.\r\n\r\n**Does this actor need a proxy or login?**\r\nNo login or credentials are needed. The actor retries short-lived rate-limit windows and may use free Apify Proxy automatically; no proxy setup is required.\r\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "yello-ae-business-listings-by-category-and-emirate",
      "title": "Yello.ae Business Listings by Category & Emirate",
      "description": "Search Yello.ae, a UAE business directory, by category and/or emirate or city, or fetch full business profiles by URL. Get names, addresses, phone numbers, categories, ratings, working hours, and websites.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Yello.ae Business Listings by Category & Emirate\r\n\r\nYello.ae is a large UAE business directory covering every emirate. This actor runs a category-and-city search against it or fetches specific business profile pages directly, returning names, addresses, phone numbers, ratings, and verification status for each — with an optional deeper pass for website, working hours, manager, establishment year, employee count, registration code, tags, description, and photos. No login, cookies, or API key required.\r\n\r\n## What this actor does\r\n\r\n- **Two modes:** `search` (category and/or city) and `detail` (direct business profile URLs)\r\n- **110 curated categories** to pick from, or type any custom category slug\r\n- **All 7 emirates plus 4 major sub-cities** available as a one-click filter (Dubai, Abu Dhabi, Sharjah, Al Ain, Ajman, Ras Al Khaimah, Jebel Ali Free Zone, Fujairah, Umm Al Quwain, Dibba, Khor Fakkan)\r\n- **Sort by** relevance, rating, or name (A-Z)\r\n- **Filter by** \"verified businesses only\" or minimum star rating (1-5)\r\n- **Rich business profiles** — full address, GPS coordinates, website (decoded from yello.ae's outbound tracking link), working hours, manager name, establishment year, employee-count bracket, registration code, listed categories, tags, description, photos, products/services, and individual written reviews\r\n- **Empty fields are omitted** — you only ever see fields that were actually found for a business\r\n\r\n## Output per business\r\n\r\n- `businessId` - yello.ae business id (search and detail)\r\n- `name` — business name\r\n- `category` — primary listed category, `categories[]` — all registered categories (when profile fetched)\r\n- `tags[]` — free-text keyword tags the business added (when profile fetched)\r\n- `rating`, `reviewCount` — average star rating (1-5) and total number of reviews\r\n- `address` — full address text (mode=search); `street`, `city`, `country` — structured address (when profile fetched)\r\n- `latitude`, `longitude` — GPS coordinates from the search-result map pin (mode=search); precise coordinates from the business profile (when profile fetched)\r\n- `verified` — yello.ae's own \"Verified\" badge status\r\n- `yearsWithUs` — years registered with yello.ae (also available from the search-result card, not only when profile fetched)\r\n- `establishedYear` — year the business itself was established\r\n- `photosCount` — number of photos on the business's yello.ae listing\r\n- `phone`, `mobilePhone`, `fax` — contact numbers (when profile fetched)\r\n- `website` — the business's own outbound website link, decoded from yello.ae's tracking redirect\r\n- `workingHours[]` — structured opening hours (`{day, hours}` per weekday; when profile fetched)\r\n- `manager` — company manager/owner name (when profile fetched)\r\n- `employeeCount` — employee-count bracket, e.g. `\"26-50\"` (when profile fetched)\r\n- `registrationCode` — business registration code (when profile fetched)\r\n- `description` — company description (when profile fetched)\r\n- `images[]`, `logoUrl` — business photos and logo (when profile fetched)\r\n- `products[]` — products/services listed on the profile (`{name, description, price, imageUrl}`; when profile fetched and the business has any)\r\n- `reviews[]` — individual written reviews (`{author, rating, title, text, date}`; when profile fetched and the business has any)\r\n- `lastUpdated`, `registeredOn` — profile last-updated and yello.ae registration timestamps (when profile fetched and the \"Verified Business\" panel is present)\r\n- `searchTotal` - total matching listings reported by Yello (mode=search)\r\n- `searchCategory`, `searchLocation` — the search parameters used (mode=search)\r\n- `sourceUrl` — canonical yello.ae profile URL for the business\r\n- `recordType: \"business\"`, `scrapedAt`\r\n\r\n## Input\r\n\r\n| Field | Type | Default | Description |\r\n|---|---|---|---|\r\n| `mode` | string (select) | `search` | `search` (category and/or city) or `detail` (fetch by URL) |\r\n| `category` | string (select) | `restaurants` | Pick a common category, or `custom` to use `customCategory`, or leave empty to browse by city only (mode=search) |\r\n| `customCategory` | string | – | Any free-text category slug, overrides `category` (mode=search) |\r\n| `city` | string (select) | – | Emirate/city to search in, or leave empty for nationwide (mode=search) |\r\n| `customCity` | string | – | Any free-text city slug, overrides `city` (mode=search) |\r\n| `sortBy` | string (select) | `relevance` | `relevance` / `rating` (highest first) / `name` (A-Z) — applied client-side across the fetched batch |\r\n| `verifiedOnly` | boolean | `false` | Only return businesses with yello.ae's \"Verified\" badge |\r\n| `minRating` | integer | `0` (no minimum) | Only return businesses rated at least 1-5 stars |\r\n| `fetchDetails` | boolean | `false` | Also visit each business's profile page for richer data (slower) |\r\n| `businessUrls` | array | – | yello.ae profile URLs to fetch directly (mode=detail) |\r\n| `maxItems` | int | `20` | Hard cap on returned records (1-1000) |\r\n\r\n### Example: search restaurants in Dubai\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"category\": \"restaurants\",\r\n  \"city\": \"dubai\",\r\n  \"maxItems\": 20\r\n}\r\n```\r\n\r\n### Example: highest-rated dentists in Abu Dhabi, with full profiles\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"category\": \"dentists\",\r\n  \"city\": \"abu-dhabi\",\r\n  \"sortBy\": \"rating\",\r\n  \"fetchDetails\": true,\r\n  \"maxItems\": 30\r\n}\r\n```\r\n\r\n### Example: verified 4+ star hotels across the whole UAE\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"category\": \"hotels\",\r\n  \"verifiedOnly\": true,\r\n  \"minRating\": 4,\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Example: all businesses in Sharjah (no category filter)\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"category\": \"\",\r\n  \"city\": \"sharjah\",\r\n  \"maxItems\": 50\r\n}\r\n```\r\n\r\n### Example: fetch specific business profiles\r\n\r\n```json\r\n{\r\n  \"mode\": \"detail\",\r\n  \"businessUrls\": [\r\n    { \"url\": \"https://www.yello.ae/company/344843/cafe-torino\" }\r\n  ]\r\n}\r\n```\r\n\r\n## Use cases\r\n\r\n- **Local lead generation** — build a prospect list of UAE businesses by trade and emirate for B2B outreach\r\n- **Market research** — measure business density and average ratings for a category across UAE regions\r\n- **Directory aggregation** — feed structured UAE business data into your own local-search product\r\n- **Competitor mapping** — see who else operates in a category and area, with ratings and contact info\r\n- **Franchise & site-selection analysis** — evaluate service-business coverage across emirates and cities\r\n\r\n## Limitations\r\n\r\n- **`sortBy` is applied client-side.** yello.ae's search-results pages don't expose a server-side sort parameter, so `rating`/`name` sorting is applied across the batch of records this run actually fetched, not the entire category.\r\n- **`verifiedOnly` and `minRating` are applied client-side.** A business with no rating on yello.ae is only excluded by `minRating` (which requires a rating to compare against).\r\n- **`website` reflects the business's own self-submitted link, as-is.** yello.ae stores this as an outbound tracking redirect which this actor decodes back to the real destination URL; the destination itself is whatever the business owner entered and is not validated by yello.ae or this actor (occasionally a business lists a social-media page instead of a proper website).\r\n- **E-mail addresses and WhatsApp numbers are not included.** yello.ae gates both behind its paid \"Data Hub\" product / a sign-in \"Send Enquiry\" form; they are not present in the publicly accessible HTML, so this actor cannot populate them.\r\n- **`reviews[]` and `products[]` are only available with `fetchDetails: true` (search mode) or `mode: detail`**, and only for businesses that have any — yello.ae's search-results cards only expose the aggregate `rating`/`reviewCount`, not individual review text or product listings; both live on the business profile page.\r\n\r\n## FAQ\r\n\r\n**What data source does this actor use?**\r\nIt reads the publicly available search and business-profile pages on yello.ae (note: this is `yello.ae`, not `yellow.ae`, which is an unrelated parked domain). No account or API key is needed.\r\n\r\n**Is this affiliated with yello.ae?**\r\nNo. This is an independent, third-party actor that reads publicly accessible pages.\r\n\r\n**Why do some businesses have no rating, phone, or website?**\r\nyello.ae only shows a rating once a business has received at least one review, and only shows contact/website details a business itself provided. Fields with no data are simply omitted from the record rather than shown as empty or null.\r\n\r\n**Can I search a whole emirate instead of a single city?**\r\nYes — every value in the `city` dropdown (Dubai, Abu Dhabi, Sharjah, Al Ain, Ajman, Ras Al Khaimah, Fujairah, Umm Al Quwain) is itself an emirate or a major city within one; Jebel Ali Free Zone, Dibba, and Khor Fakkan are additional sub-city areas yello.ae tracks separately.\r\n\r\n**Can I search all of the UAE at once?**\r\nYes — leave `city` empty (the default) for a nationwide search within a category.\r\n\r\n**How accurate are the GPS coordinates?**\r\nIn `search` mode, `latitude`/`longitude` come from the same map-pin coordinates yello.ae shows on the search-results card, so they're present without needing `fetchDetails`. With `fetchDetails: true` or in `detail` mode, they're replaced by the more precise coordinates from the business's own profile page.\r\n\r\n**Why is `fetchDetails` off by default?**\r\nFetching each business's full profile page requires one extra request per result, which is slower. Turn it on when you need website, working hours, manager, establishment year, employee count, registration code, categories/tags, description, photos, products/services, or individual reviews.\r\n\r\n**Does this actor need a proxy or login?**\r\nNo login or credentials are needed. The actor retries short-lived rate-limit windows and may use free Apify Proxy automatically; no proxy setup is required.\r\n",
      "input": {
        "title": "Yello.ae Business Listings by Category & Emirate Input",
        "description": "Search Yello UAE (yello.ae, the UAE's largest business directory with 224,000+ companies) by category and/or emirate/city, or fetch full business profiles by direct URL.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to fetch: search a category and/or city, or fetch full business profiles from direct yello.ae URLs.",
            "editor": "select",
            "enum": [
              "search",
              "detail"
            ],
            "enumTitles": [
              "Search by category & city",
              "Fetch business profiles by URL"
            ],
            "default": "search",
            "prefill": "search"
          },
          "category": {
            "title": "Category",
            "type": "string",
            "description": "Business category to search for. Pick a common category, or choose 'Custom category' and type your own below (mode=search). Leave 'No category filter' + set a city to browse all businesses in that city.",
            "editor": "select",
            "enum": [
              "custom",
              "",
              "others",
              "trading",
              "clothing-and-accessories",
              "food-retailers",
              "electrical-goods",
              "building-materials",
              "general-office-services",
              "restaurants",
              "advertising",
              "small-business",
              "vehicle-services",
              "home-and-garden",
              "construction-services",
              "estate-agents",
              "professional-services",
              "jewellery",
              "contractors",
              "car-parts-and-accessories",
              "gifts",
              "logistics",
              "industrial-equipment",
              "beauty-products",
              "building-maintenance",
              "textile",
              "transport-companies",
              "furniture",
              "overseas-business",
              "doctors-and-clinics",
              "chemicals",
              "communications",
              "car-rental",
              "industrial-services",
              "vehicle-sales",
              "travel-agents",
              "mobile-phone-shops",
              "computer-software",
              "handbagsleather-products",
              "carpentryflooring",
              "brokers",
              "plumbing-sanitary",
              "interior-design",
              "metal-products",
              "event-equipment",
              "roofing-materials-accessories",
              "web-development",
              "financial-activity",
              "hotels",
              "computer-services",
              "computer-equipment",
              "business-management-consulting",
              "construction-equipment",
              "farming",
              "online-content",
              "retail-services",
              "event-services",
              "web-design",
              "film-television-and-video",
              "secretarial-services",
              "procurement",
              "human-resources",
              "ships-boats",
              "electrical-fitting",
              "aluminium-openings",
              "beauty-professionals",
              "cleaning",
              "marketing",
              "cafes",
              "information-technology",
              "removals-and-relocation",
              "oil-natural-gas",
              "schools",
              "tour-operators",
              "arts-and-crafts",
              "software",
              "pharmacies",
              "electromechanical-equipment-installation",
              "architectural-services",
              "supermarkets",
              "chemicals-trading",
              "security",
              "medical-equipment",
              "computer-hardware",
              "banks-credit-unions",
              "management-consultants",
              "engineering",
              "decoration-materialspartitions",
              "industrial-supplies",
              "kids",
              "printing",
              "education",
              "consulting",
              "audit-and-accounting",
              "surveyors",
              "property-management-services",
              "investment-companies",
              "engineers",
              "marine-services",
              "hardware-stores-in-emirates",
              "handling-loadinglifting",
              "web-services",
              "networking",
              "photography",
              "dentists",
              "buses-rental",
              "real-estate-developers",
              "hairdressers",
              "sports",
              "shopping-centres",
              "auto-batteries",
              "lawyers"
            ],
            "enumTitles": [
              "Custom category (type below)",
              "No category filter (browse city)",
              "General Services",
              "Trading",
              "Clothing and Accessories",
              "Food Retailers",
              "Electrical Goods",
              "Building Materials",
              "General Office Services",
              "Restaurants",
              "Advertising",
              "Small Business",
              "Vehicle Services",
              "Home and Garden",
              "Construction Services",
              "Real Estate Agents",
              "Professional Services",
              "Jewellery",
              "Contractors",
              "Car Parts and Accessories",
              "Gifts",
              "Logistics",
              "Industrial Equipment",
              "Beauty Products",
              "Building Maintenance",
              "Textile",
              "Transport Companies",
              "Furniture",
              "Overseas Business",
              "Doctors and Clinics",
              "Chemicals",
              "Communications",
              "Car Rental",
              "Industrial Services",
              "Vehicle Sales",
              "Travel Agents",
              "Mobile Phone Shops",
              "Computer Software",
              "Handbags & Leather Products",
              "Carpentry & Flooring",
              "Brokers",
              "Plumbing & Sanitary",
              "Interior Design",
              "Metal Products",
              "Event Equipment",
              "Roofing Materials & Accessories",
              "Web Development",
              "Financial Activity",
              "Hotels",
              "Computer Services",
              "Computer Equipment",
              "Business Management Consulting",
              "Construction Equipment",
              "Farming",
              "Online Content",
              "Retail Services",
              "Event Services",
              "Web Design",
              "Film, Television and Video",
              "Secretarial Services",
              "Procurement",
              "Human Resources",
              "Ships & Boats",
              "Electrical Fitting",
              "Aluminium Openings",
              "Beauty Professionals",
              "Cleaning",
              "Marketing",
              "Cafes",
              "Information Technology",
              "Removals and Relocation",
              "Oil & Natural Gas",
              "Schools",
              "Tour Operators",
              "Arts and Crafts",
              "Software",
              "Pharmacies",
              "Electromechanical Equipment Installation",
              "Architectural Services",
              "Supermarkets",
              "Chemicals Trading",
              "Security",
              "Medical Equipment",
              "Computer Hardware",
              "Banks, Credit Unions",
              "Management Consultants",
              "Engineering",
              "Decoration Materials & Partitions",
              "Industrial Supplies",
              "Kids",
              "Printing",
              "Education",
              "Consulting",
              "Audit and Accounting",
              "Surveyors",
              "Property Management Services",
              "Investment Companies",
              "Engineers",
              "Marine Services",
              "Hardware Stores",
              "Handling, Loading & Lifting",
              "Web Services",
              "Networking",
              "Photography",
              "Dentists",
              "Buses Rental",
              "Real Estate Developers",
              "Hairdressers",
              "Sports",
              "Shopping Centres",
              "Auto Batteries",
              "Lawyers"
            ],
            "default": "restaurants",
            "prefill": "restaurants"
          },
          "customCategory": {
            "title": "Custom category (overrides selection above)",
            "type": "string",
            "description": "Free-text category slug not in the curated list above, e.g. 'locksmiths' or 'it-services' (mode=search). Takes priority over 'Category' when set. Use the slug shown in a yello.ae category URL (lowercase, hyphenated).",
            "editor": "textfield"
          },
          "city": {
            "title": "Emirate / city",
            "type": "string",
            "description": "UAE emirate or city to search in. Combine with 'Category' to search a category within one city, or leave category empty to browse all businesses in the city (mode=search).",
            "editor": "select",
            "enum": [
              "",
              "dubai",
              "abu-dhabi",
              "sharjah",
              "al-ain",
              "ajman",
              "ras-al-khaimah",
              "jebel-ali-free-zone",
              "fujairah",
              "um-al-quwain",
              "dibba",
              "khor-fakkan"
            ],
            "enumTitles": [
              "No city filter (nationwide)",
              "Dubai",
              "Abu Dhabi",
              "Sharjah",
              "Al Ain",
              "Ajman",
              "Ras Al Khaimah",
              "Jebel Ali Free Zone (JAFZ)",
              "Fujairah",
              "Umm Al Quwain",
              "Dibba",
              "Khor Fakkan"
            ],
            "default": "",
            "prefill": "dubai"
          },
          "customCity": {
            "title": "Custom city (overrides selection above)",
            "type": "string",
            "description": "Free-text city slug not in the curated list above (mode=search). Takes priority over 'Emirate / city' when set.",
            "editor": "textfield"
          },
          "sortBy": {
            "title": "Sort order",
            "type": "string",
            "description": "How to order search results after fetching (mode=search). yello.ae itself only returns relevance order, so 'rating' and 'name' are applied client-side across the fetched batch.",
            "editor": "select",
            "enum": [
              "relevance",
              "rating",
              "name"
            ],
            "enumTitles": [
              "Relevance (yello.ae's own order)",
              "Rating (highest rated first)",
              "Name (A-Z)"
            ],
            "default": "relevance",
            "prefill": "relevance"
          },
          "verifiedOnly": {
            "title": "Verified businesses only",
            "type": "boolean",
            "description": "Only return businesses with yello.ae's own 'Verified' badge (mode=search).",
            "default": false,
            "prefill": false
          },
          "minRating": {
            "title": "Minimum rating",
            "type": "integer",
            "description": "Only return businesses rated at least this many stars, e.g. 4 for 4.0+ (mode=search). 0 means no minimum. Businesses with no rating are excluded once this is set above 0.",
            "minimum": 0,
            "maximum": 5,
            "default": 0,
            "prefill": 0
          },
          "fetchDetails": {
            "title": "Fetch full business profiles",
            "type": "boolean",
            "description": "For each search result, also visit its business profile page to collect full address, website, working hours, manager, establishment year, employee count, registration code, categories/tags, description, and photos. Slower -- one extra request per result (mode=search).",
            "default": false,
            "prefill": false
          },
          "businessUrls": {
            "title": "Business profile URLs (mode=detail)",
            "type": "array",
            "description": "Direct yello.ae business profile URLs to fetch, e.g. https://www.yello.ae/company/344843/cafe-torino. Use the 'sourceUrl' field from search results.",
            "editor": "requestListSources",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "title": "URL",
                  "type": "string",
                  "description": "yello.ae business profile URL."
                }
              }
            },
            "default": [],
            "prefill": []
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on the number of business records to return.",
            "minimum": 1,
            "maximum": 1000,
            "default": 20,
            "prefill": 3
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Yello.ae Business Listings by Category & Emirate Output",
        "description": "UAE business listings from yello.ae — names, addresses, phone numbers, categories, ratings, working hours, and websites.",
        "properties": {
          "businesses": {
            "type": "string",
            "title": "Yello UAE businesses",
            "description": "Dataset containing all scraped yello.ae business listings.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Businesses",
              "transformation": {
                "fields": [
                  "name",
                  "category",
                  "city",
                  "address",
                  "phone",
                  "rating",
                  "reviewCount",
                  "website",
                  "sourceUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "285714cd752fa83a74a6ad960dba81ee7119ab43ac38b1d159588f03cb888afe",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.015922222222222223
    }
  }
}