# Egypt Yellow Pages Scraper - Business Directory (`crawlerbros/yellow-pages-egypt-scraper`) Actor Scrape yellowpages.com.eg, Egypt's official business directory. Search by keyword, browse by category or brand, or fetch business profiles by URL. Get names, addresses, phone numbers, websites, ratings, working hours, and social links. - **URL**: https://apify.com/crawlerbros/yellow-pages-egypt-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Egypt Yellow Pages Scraper Scrape **yellowpages.com.eg** — Egypt's official online business directory. Search any keyword or browse any of 700+ business categories and 200+ popular brands, and get names, full addresses, governorates, phone numbers, websites, ratings, working hours, and social links. No login, no cookies, no API key, no proxy required. ### What this actor does - **Five modes:** `search` (site-wide keyword search), `byCategory` (browse one of 700+ real categories), `byBrand` (browse one of 200+ popular brands), `byKeyword` (browse a specific tag/keyword page), and `byUrls` (fetch specific businesses by direct profile URL) - **Full category and brand dropdowns**, or type any custom slug - **Governorate filter** — restrict results to any of Egypt's 27 governorates (Cairo, Giza, Alexandria, and every other governorate) - **Filter by** minimum star rating (1-5), "has website", "has phone number" - **English or Arabic** — pick the site locale; Arabic output is full native-script text (valid UTF-8), not transliterated - **Rich business profiles** — every listing is enriched with its full detail page: phone number, website, GPS coordinates, working hours, rating and review count, full category/keyword lists, social links, WhatsApp number, accepted payment methods, and photo gallery - **Empty fields are omitted** — you only ever see fields that were actually found for a business ### Output per business - `companyId` — Yellow Pages internal business ID - `name` — business name - `category` — primary business category; `categories[]` — every category the business is listed under - `keywords[]` — search keywords/tags associated with the business - `description` — business description - `rating` (1-5), `reviewCount` — from the business's own review data, when available - `fullAddress` — the complete published address; `street`, `area`, `governorate` — best-effort parsed parts - `latitude`, `longitude` — GPS coordinates - `phone` — primary phone number - `whatsapp` — WhatsApp contact number, when listed - `website` — business website - `facebookUrl`, `instagramUrl`, `twitterUrl`, `linkedinUrl`, `youtubeUrl`, `tiktokUrl` — social media profiles, when listed - `workingHours[]` — structured working hours (`{day, hours}` per weekday), when published - `services[]` — named services offered, when published - `paymentMethods[]` — accepted payment methods (e.g. Visa, Mastercard, Cash), when published - `photoUrls[]` — up to 5 photos from the business's gallery - `logoUrl` — business logo - `sourceUrl` — canonical Yellow Pages business profile URL - `recordType: "business"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string (select) | `search` | `search` (keyword), `byCategory` (browse), `byBrand` (browse), `byKeyword` (browse a tag), or `byUrls` (fetch by URL) | | `query` | string | `restaurants` | Keyword to search for (mode=search) | | `category` | string (select) | `doctors` | Pick from 700+ real categories, or `custom` to use `customCategory` (mode=byCategory) | | `customCategory` | string | – | Any category slug, overrides `category` (mode=byCategory) | | `brand` | string (select) | `toyota` | Pick from 200+ popular brands, or `custom` to use `customBrand` (mode=byBrand) | | `customBrand` | string | – | Any brand slug, overrides `brand` (mode=byBrand) | | `keyword` | string | `dentist` | Tag/keyword slug to browse (mode=byKeyword) | | `businessUrls` | array | – | Yellow Pages business profile URLs to fetch directly (mode=byUrls) | | `language` | string (select) | `en` | `en` (English) or `ar` (Arabic) site locale | | `governorate` | string (select) | – (all) | Restrict results to one of Egypt's 27 governorates | | `minRating` | integer | `0` (no minimum) | Only return businesses rated at least 1-5 stars | | `requireWebsite` | boolean | `false` | Only return businesses with a listed website | | `requirePhone` | boolean | `false` | Only return businesses with a listed phone number | | `maxItems` | int | `20` | Hard cap on returned records (1-1000) | #### Example: search for restaurants site-wide ```json { "mode": "search", "query": "restaurants", "maxItems": 20 } ```` #### Example: browse dentists in Cairo with at least a 4-star rating ```json { "mode": "byCategory", "category": "dentists", "governorate": "cairo", "minRating": 4, "maxItems": 30 } ``` #### Example: Toyota dealers with a published website and phone number ```json { "mode": "byBrand", "brand": "toyota", "requireWebsite": true, "requirePhone": true, "maxItems": 50 } ``` #### Example: browse every business tagged "pizza" ```json { "mode": "byKeyword", "keyword": "pizza", "maxItems": 30 } ``` #### Example: fetch specific businesses by URL, in Arabic ```json { "mode": "byUrls", "language": "ar", "businessUrls": [ { "url": "https://yellowpages.com.eg/en/profile/mcdonald's/17549" } ] } ``` ### Use cases - **Local lead generation** — build a prospect list of Egyptian businesses by category, brand, or governorate for B2B outreach - **Market research** — measure business density and average ratings for a category across Egypt's governorates - **Directory aggregation** — feed structured Egyptian business data into your own local-search product - **Competitor mapping** — see who else operates in a category or sells a brand, with ratings and contact info - **Franchise/dealer network audits** — pull every listed branch of a brand nationwide ### Limitations - **`governorate` is a client-side address filter, not a server-side one.** The site's own location filter is a JavaScript-driven form with no stable URL/GET form, so `governorate` instead matches the parsed governorate segment of each business's published address (accent- and case-insensitive, with common English/Arabic spelling variants). This works uniformly across every mode. - **`search` reflects the site's own relevance ranking**, including its fallback behavior for very short or unusual queries. Longer, more specific keywords (e.g. a category name or product type) return the most focused results. - **Automatic proxy fallback.** This actor may automatically route a small fraction of requests through Apify's free datacenter proxy pool for reliability. No user configuration or paid proxy plan is required. - **One extra request per result.** Every listing result is automatically enriched with its detail page (phone/rating/hours/social links/coordinates only exist there, not on listing cards), so results take roughly twice as long per record as a listing-only scrape — this is by design, to guarantee complete records. ### FAQ **What data source does this actor use?** It reads the publicly available search, category-browse, brand-browse, and business-detail pages on yellowpages.com.eg, Egypt's official business directory. No account or API key is needed. **Is this affiliated with Yellow Pages Egypt?** No. This is an independent, third-party actor that reads publicly accessible pages. **Why do some businesses have no rating, phone, or working hours?** Yellow Pages Egypt only shows these fields once a business has received reviews or has published that information itself. Fields with no data are simply omitted from the record rather than shown as empty or null. **What's the difference between `category` and `categories`?** `category` is the primary category shown in the breadcrumb. `categories[]` includes every category the business is listed under (some businesses span several, e.g. a clinic listed under both "Doctors" and "Dermatologists"). **Can I get results in Arabic?** Yes — set `language` to `ar` and every text field (name, description, address, categories, keywords) is returned in Arabic exactly as published, with full parity to the English version. **Does this actor need a proxy or login?** No — yellowpages.com.eg's search, category, brand, and detail pages are served without any login wall, so this actor runs entirely on Apify's free plan with no proxy and no credentials. **How do I find a category or brand slug?** Browse https://yellowpages.com.eg/en/related-categories or https://yellowpages.com.eg/en/related-brands and copy the URL segment after `/en/category/` or `/en/brand/`, or just pick it from the dropdown. **What's the difference between `byCategory`, `byKeyword`, and `search`?** `byCategory` browses a broad taxonomy category (e.g. "Restaurants"). `byKeyword` browses a narrower tag every business can carry (e.g. "Pizza", "Dentist") — the same tags shown in each business's own `keywords[]` field. `search` is free-text and matches names, categories, and keywords all at once. # Actor input Schema ## `mode` (type: `string`): What to fetch: free-text keyword search, browse a full business category, browse a brand, browse a tag/keyword page, or fetch specific business profiles by URL. ## `query` (type: `string`): Keyword to search for, e.g. a business name, product, service, or category ('restaurants', 'dentist', 'car rental'). Used when mode=search. Matches business names, categories, and keywords across the whole directory. ## `category` (type: `string`): Business category to browse (mode=byCategory). Pick from the full Egypt Yellow Pages category list, or choose 'Custom category' and type your own slug below. ## `customCategory` (type: `string`): Free-text category slug, e.g. 'doctors' or 'real-estate' (mode=byCategory). Find the slug by browsing https://yellowpages.com.eg/en/related-categories and copying the URL segment after /en/category/. Takes priority over 'Category' when set. ## `brand` (type: `string`): Brand to browse (mode=byBrand). Pick from the most popular Egypt Yellow Pages brands, or choose 'Custom brand' and type your own slug below. ## `customBrand` (type: `string`): Free-text brand slug, e.g. 'toyota' or 'samsung' (mode=byBrand). Find the slug by browsing https://yellowpages.com.eg/en/related-brands and copying the URL segment after /en/brand/. Takes priority over 'Brand' when set. ## `keyword` (type: `string`): Tag/keyword slug to browse (mode=byKeyword), e.g. 'dentist' or 'pizza'. Every business listing carries its own keyword tags (visible in the `keywords` output field of any other mode) -- browsing by one of those tags returns every business tagged with it, which is broader than a category and more specific than a free-text search. Find slugs from the `keywords` field of prior results, or from the URL segment after /en/keyword/ when browsing the site. ## `businessUrls` (type: `array`): Direct yellowpages.com.eg business profile URLs to fetch, e.g. https://yellowpages.com.eg/en/profile/some-business/12345. Use the 'sourceUrl' field from search/category results. ## `language` (type: `string`): Site locale to scrape from. English returns Latin-script text; Arabic returns the business's native Arabic listing (fully supported, valid UTF-8 output). Applies to all modes. ## `governorate` (type: `string`): Only return businesses located in this Egyptian governorate (applies to any mode). Leave as 'All governorates' for nationwide results. Matched against the business's published address. ## `requireWebsite` (type: `boolean`): Only return businesses that have a website listed on their Yellow Pages profile. ## `requirePhone` (type: `boolean`): Only return businesses that have a phone number listed on their Yellow Pages profile. ## `minRating` (type: `integer`): Only return businesses rated at least this many stars (1-5). 0 means no minimum. Businesses with no rating are excluded once this is set above 0. ## `maxItems` (type: `integer`): Hard cap on the number of business records to return. ## Actor input object example ```json { "mode": "search", "query": "restaurants", "category": "doctors", "brand": "toyota", "keyword": "dentist", "businessUrls": [], "language": "en", "governorate": "", "requireWebsite": false, "requirePhone": false, "minRating": 0, "maxItems": 20 } ``` # Actor output Schema ## `businesses` (type: `string`): Dataset containing all scraped yellowpages.com.eg business listings. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "query": "restaurants", "category": "doctors", "brand": "toyota", "keyword": "dentist", "businessUrls": [], "language": "en", "governorate": "", "requireWebsite": false, "requirePhone": false, "minRating": 0, "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/yellow-pages-egypt-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "query": "restaurants", "category": "doctors", "brand": "toyota", "keyword": "dentist", "businessUrls": [], "language": "en", "governorate": "", "requireWebsite": False, "requirePhone": False, "minRating": 0, "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/yellow-pages-egypt-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "search", "query": "restaurants", "category": "doctors", "brand": "toyota", "keyword": "dentist", "businessUrls": [], "language": "en", "governorate": "", "requireWebsite": false, "requirePhone": false, "minRating": 0, "maxItems": 20 }' | apify call crawlerbros/yellow-pages-egypt-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/yellow-pages-egypt-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Egypt Yellow Pages Scraper - Business Directory", "description": "Scrape yellowpages.com.eg, Egypt's official business directory. Search by keyword, browse by category or brand, or fetch business profiles by URL. Get names, addresses, phone numbers, websites, ratings, working hours, and social links.", "version": "1.0", "x-build-id": "gu5swIrZ29ccQiyGO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~yellow-pages-egypt-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-yellow-pages-egypt-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~yellow-pages-egypt-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-yellow-pages-egypt-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~yellow-pages-egypt-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-yellow-pages-egypt-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byCategory", "byBrand", "byKeyword", "byUrls" ], "type": "string", "description": "What to fetch: free-text keyword search, browse a full business category, browse a brand, browse a tag/keyword page, or fetch specific business profiles by URL.", "default": "search" }, "query": { "title": "Search keyword", "type": "string", "description": "Keyword to search for, e.g. a business name, product, service, or category ('restaurants', 'dentist', 'car rental'). Used when mode=search. Matches business names, categories, and keywords across the whole directory.", "default": "restaurants" }, "category": { "title": "Category", "enum": [ "custom", "abrasives", "accountant", "acrylic", "adhesives-and-glues", "advertising-agencies", "advertising-machinery-&-supplies", "advertising-outdoor-_-signs-&-billboards", "advertising-promotional-items", "agricultural-products", "agriculture", "agriculture-directorates", "air-conditioning", "aircraft-charters", "aircrafts", "airlines", "airport-equipment-and-services", "airports", "al_azhar-education-areas", "aluminum", "ambulance-agencies", "american-restaurants", "anesthesiologists", "animal-food", "antennas", "antiques", "appeal-courts", "appliances", "appliances-maintenance-and-spare-parts", "appraisal", "architects", "armories,-guns-&-ammunition", "art-schools", "artificial-flowers", "artificial-grass-and-playground-equipment", "artificial-limbs", "arts,-crafts,-and-supplies", "asian-restaurants", "assay-&-weights-administration", "associations-and-organizations", "atms", "auctions", "audio-and-video-equipment", "australian-restaurants", "automotive-device-&-equipment-center", "automotive-service-centers", "azharian-schools", "b.-b.-q.", "bakery-&-pastry-equipment", "bakery-&-pastry-shops", "balancing-dynamic-equipment", "bank-equipment", "banks", "barcode", "batteries", "bazaars", "beaches", "bearings", "beauty-salons", "bedding", "bee's-honey,-beekeepers-&-supplies", "belgian-cuisine", "beverage-industry", "bicycles", "billiard-equipment", "billiard-parlors", "biotechnology", "blood-transfusion-centers", "blueprinting", "boilers,-burners-&-heaters", "bolts,-nuts,-nails-&-screws", "books", "bowling-alleys-and-equipment", "broadcasters-radio-&-television", "building-hardware", "building-materials", "buildings,-pre_fabricated-&-structures", "burger", "bus-charters-&-stations", "business-consulting", "butchers", "cable-&-wire", "cafes-and-coffee-shops", "call-centers,-telemarketing-&-teleseen", "can-manufacturers", "canal-co.-for-electricity-distribution", "candles", "candy-&-confectionery", "car-dealerships", "car-glass", "car-tire-equipment-&-supplies", "cardiologists", "carpenters-&-equipment", "carpets-&-rugs", "cars-&-buses-air-conditioning", "cars-body-_-manufacturing,-repairing-&-painting", "cars-manufacturers-&-assemblers", "cars-parts-&-accessories", "cars-rentals-&-limousines", "cars-wash", "carton-&-corrugated-products", "casinos", "caterers", "cd-rom,-dvd-&-media-replication", "cd,-dvd,-play-station,-x_box-&-computer-games", "ceilings", "cement,-concrete,-gypsum-&-brick", "cemeteries", "central-agency-for-public-mobilization-&-statistics-data", "central-air-conditioning", "central-heating", "ceramic-&-porcelain", "chambers-of-commerce", "charcoal", "charitable-organizations", "chemicals", "chewing-gum-raw-materials", "chicken-restaurants", "children's-clothing-store", "chinese-restaurants", "churches-&-monasteries", "cinemas-&-theaters", "city-authority", "civil-registry", "civil-status-administrations", "cleaning-services,-products-&-equipment", "clothing-accessories", "clothing-factories-&-wholesalers", "clothing-shops", "clubs", "coffee-grinder", "coffee-machine", "collection-agencies-&-electronic-payment-services", "color-separation", "commercial-agencies", "commercial-registry", "commercial-secondary-schools", "comprehensive-health-insurance-clinics", "compressors", "computer-courses", "computer-hardware", "computer-integrated-systems-&-solutions", "computer-networking", "computer-printers-and-parts", "computer-software", "condensers-&-evaporators", "conference-centers", "construction", "construction-equipment", "consultants", "control-systems-and-equipment", "control-systems-and-regulators", "conveyor-belts", "cooling-towers-&-ventilating", "corona-virus-test-centers", "cosmetics", "courier", "coworking-spaces", "crepe-and-waffle", "cruises", "cultural-centers", "culture-directorates", "culture-palace-&-house", "curtains-and-window-coverings", "customs-clearing", "dairy-industry", "delivery-service", "dental-equipment", "dentist-clinics", "denturists", "dermatologists", "detergents-and-soaps", "diabetes-treatment-centers", "die-casting", "diesel-engines", "dietary-supplements", "digital-marketing", "directorates-of-supply-&-internal-trading", "discount-cards", "disinfectants", "districts", "diving-centers,-safari,-and-sea-trips", "doctors", "doctors-_-alternative-medicine", "doctors-_-audiologists-&-phoneticians", "document-management", "dog-farms", "door-and-window-accessories", "doors,-gates,-garage-doors-&-fences", "drilling", "dry-cleaning", "duty-free-shops", "dyers", "e_commerce", "economic-courts", "education-directorates", "educational-and-teaching-aids", "educational-services", "egypt-post", "egyptian-endowments-authority", "egyptian-environmental-affairs-agency", "egyptian-restaurants", "electric-contractors-&-electricians", "electric-machines", "electric-motors", "electrical-supplies", "electricity,-power-protection,-control-units-and-insulators", "electromechanical", "electromechanical-_-maintenance-services", "electromechanical-contracting", "electroplating", "electrostatic", "elementary-courts", "elevators", "embassies-&-consulates", "embroidery", "emergency-numbers", "endocrinologists", "endowments-directorates", "engine-repair-and-rebuild", "engineering-of-water-resources-&-irrigation", "engineers", "english-restaurants", "environment-protection", "epoxy", "escalators", "exchange-offices", "experimental-schools", "facility-management", "factory-equipment-and-supplies", "faculties-of-tanta-university", "family-courts", "family-disputes-settlement-offices", "fashion-show-specialists", "fast-food", "fertility-doctors", "fertilizers", "feteer", "fiber-and-concrete-reinforced-glass", "fiberglass", "film,-video,-television-services-and-subtitles", "finance-leasing", "fire-emergency", "fire-fighting", "fish-aquariums-and-supplies", "fish-store", "fishing", "flags-and-banners", "flavors,-fragrances,-coloring-extracts-and-essential-oils", "flooring", "foam", "food-court", "food-oils-and-natural-oils", "food-producers-and-equipment", "food-truck", "foreign-ministry-legalization-offices", "forklifts,-cranes-and-hoists", "foul-and-falafel", "fountains", "franchise", "french-restaurants", "fruit-and-vegetable", "funeral-services", "furniture-moving", "gallery", "games-_-mobile-phones", "gas-stations", "gases-and-propane", "gaskets", "gastroenterologists", "gears", "general-administrations-for-water-resources-&-irrigation", "general-administrations-of-drainage", "general-authority-for-health-insurance", "general-organization-for-export-&-import-control-_-goeic", "general-practitioners", "generators", "german-restaurants", "gerontologists", "gift-shops", "glass", "glass-coating-&-tinting", "go-karting", "golf-course-equipment", "golf-courses", "gourmet-foods", "government-organizations", "government-schools", "governmental-purchases-portal", "governmental-services-_-office-&-institutions", "graphic-design", "grease-and-industrial-oils", "greek-restaurants", "gulf-restaurants", "gym", "hairdresser-equipment", "health-affairs-directorates", "health-bureaus", "healthcare-services-&-consultancy", "healthy-food", "heavy-equipment-&-spare-parts", "heavy-transport", "hematologists", "herbalists", "holding-co.-for-water-&-waste-water", "holding-companies", "hologram", "home,-office-and-garden-furniture", "homemade-food", "horses-riding,-stables-and-supplies", "hospitals-&-medical-centers", "hospitals-_-governmental-mandate", "hot-air-balloon", "hotel-&-restaurant-management", "hotel-and-restaurant-equipment", "hotels-&-resorts", "household-products", "housekeeping-services", "housewares-products", "hydraulic-companies", "ice-&-ice-making-equipment", "ice-cream-&-dairy", "immigration-offices", "immunologists", "import-&-export", "indian-restaurant", "industrial-consulting", "industrial-control-authority-_-ica", "industrial-development-authority-_-ida", "industrial-safety", "industrial-secondary-schools", "industrial-supplies", "information-centers", "insulation", "insurance", "interior-design", "international-cuisine", "international-schools", "internet-cafe", "internists", "investment-companies", "iranian-restaurants", "isp-_-internet-service-providers", "italian-food", "jacuzzis-and-steam-baths", "japanese-restaurants", "jewelers", "juice", "kindergarten-and-child-care-centers", "kitchens", "korean-food", "koshari", "labels-and-stickers", "labor-bureaus", "laboratories-medical", "labour-supply-&-services", "lamps,-chandeliers-and-lighting-systems", "landscaping-and-equipment", "language-centers", "language-schools", "laundry-equipment", "lawyers", "leather-and-tanning", "lebanese-restaurants", "lining", "livestock-and-animal-production", "locksmiths", "maazoun", "makeup-artists-and-veil-specialists", "malaysian-restaurants", "malls", "maps-and-geographical-information-systems", "marble-and-granite", "maritime", "marketing-consultants", "marriage-offices", "matches-and-lighters", "mattresses", "measuring-tools-and-gauges", "mechanical-engineering", "media-complexes", "medical-complex", "medical-equipment", "medical-equipments", "medical-supplies", "mediterranean-food", "men-hair-stylist", "metal-products-and-machinery", "metallic-paint", "mexican-restaurants", "microfilm", "middle-egypt-electricity-distribution-co.", "mills-and-flour-mills", "mining-companies", "ministries", "ministries-&-government-organizations", "ministry-of-agriculture-&-land-reclamation-_-agriculture-research-center", "ministry-of-agriculture-&-land-reclamation-_-egyptian-agricultural-authority", "ministry-of-agriculture-&-land-reclamation-_-general-authority-for-reconstruction-projects-&-agricul", "ministry-of-agriculture-&-land-reclamation-_-general-organization-for-veterinary-services", "ministry-of-agriculture-&-land-reclamation-_-livestock-&-poultry-development-sector", "ministry-of-culture-_-cultural-production-affairs-sector", "ministry-of-culture-_-general-authority-for-national-library-&-archives", "ministry-of-electricity-&-energy-_-electricity-distribution-co.", "ministry-of-endowments-_-general-chamber-of-egyptian-endowments-ministry", "ministry-of-health-_-central-administration-of-pharmaceutical-affairs", "ministry-of-health-_-central-health-laboratories", "ministry-of-health-_-medical-insurance-hospitals", "ministry-of-higher-education", "ministry-of-higher-education-_-cairo-university", "ministry-of-higher-education-_-el-zagazig-university", "ministry-of-higher-education-_-general-administration-for-private-institutes", "ministry-of-higher-education-_-general-administration-for-students-&-education-affairs", "ministry-of-higher-education-_-general-administration-for-students-admission", "ministry-of-higher-education-_-menia-university", "ministry-of-higher-education-_-solidarity-social-fund", "ministry-of-higher-education-_-south-valley-university", "ministry-of-housing,-utilities-&-urban-development-_-district-presidency", "ministry-of-housing,-utilities-&-urban-development-_-housing-&-utilities-directorate", "ministry-of-housing,-utilities-&-urban-development-_-new-housing-communities-organization", "ministry-of-housing,-utilities-&-urban-development-_-the-general-authority-for-construction-&-housin", "ministry-of-housing,-utilities-&-urban-development-_-the-local-unit", "ministry-of-insurance-&-social-affairs-_-blinds-care-associations", "ministry-of-insurance-&-social-affairs-_-central-administration-for-social-care", "ministry-of-insurance-&-social-affairs-_-central-administration-for-unions-&-associations", "ministry-of-insurance-&-social-affairs-_-deaf-&-mute-care-associations", "ministry-of-insurance-&-social-affairs-_-intellectual-education-associations-for-special-needs", "ministry-of-insurance-&-social-affairs-_-nasser-social-bank", "ministry-of-insurance-&-social-affairs-_-nurseries-for-special-needs", "ministry-of-insurance-&-social-affairs-_-physiotherapy-centers-for-special-needs", "ministry-of-insurance-&-social-affairs-_-special-needs-associations", "ministry-of-insurance-&-social-affairs-_-special-needs-language-centers", "ministry-of-investment-_-egyptian-financial-supervisory-authority", "ministry-of-local-development-_-district-presidency", "ministry-of-local-development-_-housing-&-utilities-directorate", "ministry-of-local-development-_-the-local-unit", "ministry-of-petroleum-_-egyptian-mineral-resources-authority", "ministry-of-supply-&-internal-trading-_-directorate-of-supply-&-internal-trading", "ministry-of-the-interior-_-general-administration-of-work-permits", "ministry-of-the-interior-_-general-department-of-administrative-affairs", "ministry-of-the-interior-_-passports,-emigration-&-nationality-administration", "ministry-of-tourism-_-tourism-development-general-authority", "ministry-of-tourism-_-touristic-companies-&-shops-sector", "ministry-of-trade-&-industry-_-central-administration-for-commercial-registration", "ministry-of-trade-&-industry-_-central-administration-for-exports-&-provenance", "ministry-of-trade-&-industry-_-directorate-of-supply-&-internal-trading", "ministry-of-trade-&-industry-_-egyptian-organization-for-standardization-&-quality", "ministry-of-trade-&-industry-_-general-organization-for-international-exhibitions-&-fairs", "ministry-of-trade-&-industry-_-industrial-&-mining-organization", "ministry-of-trade-&-industry-_-industrial-registry", "ministry-of-transportation-_-alexandria-port-authority", "ministry-of-transportation-_-egyptian-national-railways", "ministry-of-transportation-_-general-roads,-bridges-&-land-transport-association", "ministry-of-transportation-_-river-transport-authority", "ministry-of-transportation-_-the-egyptian-authority-of-maritime-safety", "mobile-phones-and-line-operators", "mobiles-and-accessories", "money-transfer", "moroccan-restaurant", "mosques", "motorcycle,-auto-rickshaw-and-atvs", "moulds", "museums-and-historical-places", "musical-instruments,-equipment-&-instruction", "national-council-for-youth-_-sport-&-youth-directorate", "national-sports-council-of-egypt-_-sport-&-youth-directorate", "nature-reserves", "nephrologists", "neurologists-and-neurosurgeons", "new-cars-dealers", "newspapers-and-magazines", "night-spots", "noodles-restaurant", "north-delta-electricity-distribution-co.", "nurseries-&-tree-services", "nutritionists-and-dietitians", "obstetricians-and-gynaecologists", "occasions-hall", "office-equipment", "oil", "oil,-gas-and-air-filters", "oncologists", "online-shopping", "ophthalmologists", "opticians", "optometrists", "organizing-exhibitions,-conferences-and-performances", "oriental-food", "orthopedists", "otolaryngologist", "packaging", "pain-physicians", "paint-and-coating", "pakistani-restaurants", "palestine", "paper", "papyrus", "partitions", "passport-offices", "pasta", "patents,-trademarks-and-intellectual-property", "pediatricians", "perfumes", "pest-control-and-insecticides", "pet-shops", "pharmaceutical", "pharmacies", "pharmacies-home-delivery", "phonetic-center", "phosphates", "photo-studios", "photocopiers-&-business-centers", "photographers", "physiotherapy-centers", "picture-frames", "pipes,-tubes-&-pipelines", "pizza", "planning-and-financing-companies", "plastic-&-rubber", "plastic-surgeons", "plastic-surgery-centers", "playgrounds-&-amusement-parks", "police-departments", "police-stations", "political-parties", "portuguese-restaurants", "poultry-farms", "poultry-shops", "printing-&-equipment", "private-schools", "processed-meat", "productivity-&-vocational-training-department", "professional-health-&-safety-bureaus", "project-management", "psychiatric-&-addiction", "psychiatrists", "public-libraries", "public-taxes-missions", "publishers", "pumps", "quality", "quarries", "radiologists", "radiology-center", "railway-stations", "ramadan-food-bags", "razors-&-blades", "ready-mix-concrete", "real-estate", "real-estate-registration-offices", "real-estate-taxes-directorates", "recording-studios", "recruitment", "refractories", "refrigerators,-freezers-&-cold-storage", "residential-compounds", "restaurants", "restaurants-eat-out", "restaurants-home-delivery", "restaurants-on-the-nile", "retirement-home", "rheumatologists", "roads-&-transportation-directorates", "roads-equipment-&-services", "roasteries", "roses-and-natural-flowers", "russian-cuisine", "safari-&-camping-services", "sales-taxes-missions", "salt", "sanitary-drainage", "sanitaryware,-plumbing-equipment-&-plumbers", "satellite-receiving-equipment", "scaffolding-&-ladders", "scales-&-weighing-equipment", "scarves", "schools-_-dancing", "schools-_-driving", "scientific-equipment,-instruments-&-lab-chemicals", "scientific-research", "sea-ports", "seafood", "seals", "security-and-guards-services", "security-cameras-&-systems", "self-service-laundry", "sewing-machines", "shelving-&-storage-systems", "shipping,-air-cargo-&-freight", "shoes-&-bags-retail", "shopping-centers", "silk-screening", "silver-&-silversmiths", "skin,-hair-and-health-care-products", "slaughterhouses", "smart-&-automated-parking", "smart-card", "social-affairs-administrations", "social-affairs-directorates", "social-fund-for-development-_-sfd", "social-insurance-bureaus", "social-rehabilitation-centers", "social-rehabilitation-offices-for-disabled", "solar-energy", "spanish-restaurants", "spas", "special-needs-schools-&-centers", "specialized-medical-centers", "spices-&-herbs", "sponge", "sporting-goods-&-equipment", "sports-academies", "stadiums,-grandstands-&-bleachers", "stained,-leaded-and-carved-glass", "stainless-steel", "stationery", "steak-houses", "steel-&-iron", "steel-heat-treatment", "sterilization-&-disinfection", "stock-&-bond-brokers", "store-displays", "sudanese-restaurants", "sugar", "sunshade-fabric", "supermarket-equipment", "supermarkets", "supermarkets-home-delivery", "supplementary-industries", "supply-bureaus", "surgeons", "surveying-&-equipment", "sushi", "swimming-pool-contractors-&-chemicals", "swiss-restaurants", "syndicates", "syrian-restaurants", "tailors", "tanks", "taxies", "tea-&-coffee", "telecommunications", "televisions-closed-circuit", "tents,-awnings-&-canopies", "textiles", "thai-restaurants", "the-ministry-of-education", "theatrical-equipment-&-supplies", "therapeutic-massage", "tiles", "tires", "tissues", "tobacco", "tools", "tourism-development", "towing", "toys", "traffic-consultants", "traffic-stations", "training-centers-&-specialized-schools", "translation", "transport-and-logistics-services", "travel-agents", "travel-bags", "trophies,-medals-and-plaques", "trucks-&-buses", "turkish-bath", "turkish-cuisine", "turning", "uniforms", "uninterruptible-power-supplies", "universities,-colleges-&-institutes", "upholsterers", "urologists", "used-cars", "valves-&-taps", "vascular-surgeon", "vending-machines", "venereologists", "ventilation-systems-fans", "veterinarians", "veterinary-medicine-directorates", "villages-_-touristic", "vocational-training-centers", "waste-management-&-recycling-services", "watches-&-clocks", "water-bottled-&-bulk", "water-parks", "water-treatment", "waterproofing,-heat-proofing-&-fireproofing", "watersports", "we-_-telecom-egypt", "web-design", "wedding-and-party-planning", "wedding-and-soiree-dresses", "wedding-venues", "weight-loss-and-nutrition-centers", "welding", "wholesale-food", "wind-energy", "women-accessories", "wood", "work-&-safety-wear", "zinc", "zippers", "zoos" ], "type": "string", "description": "Business category to browse (mode=byCategory). Pick from the full Egypt Yellow Pages category list, or choose 'Custom category' and type your own slug below.", "default": "doctors" }, "customCategory": { "title": "Custom category (overrides selection above)", "type": "string", "description": "Free-text category slug, e.g. 'doctors' or 'real-estate' (mode=byCategory). Find the slug by browsing https://yellowpages.com.eg/en/related-categories and copying the URL segment after /en/category/. Takes priority over 'Category' when set." }, "brand": { "title": "Brand", "enum": [ "custom", "acer", "activ", "adidas", "alcatel", "alfa", "amricool", "apple", "arab-african-international-bank", "ariston", "astra", "asus", "audi", "b.tech", "babyliss", "bavaria", "beats", "bmw", "bosch", "boss", "braun", "bridgestone", "brother", "bulgari", "burberry-brit", "bvlgari", "byblos", "canon", "carrera", "carrier", "cartier", "casio", "cat", "caterpillar", "ceramica-royal", "chanel", "chevrolet", "christian-dior", "cisco", "citizen", "citroen", "ck", "cleopatra", "compac", "compaq", "continental", "cottonil", "cummins", "d-&-g", "daewoo", "dahua", "daihatsu", "dell", "dice", "diesel", "dolce-&-gabbana", "duravit", "dyo", "electrostar", "emporio-armani", "epson", "escada", "etisalat", "fiat", "fila", "ford", "fred", "fresh", "geely", "gemsound", "general-electric", "georgio-armani", "gigabyte", "givenchy", "goldi", "good-year", "gree", "gucci", "guess", "habitat", "hankook", "harman%2Fkardon", "hik-vision", "hisense", "hitachi", "honda", "honeywell", "hp", "hsbc", "htc", "huawei", "hugo-boss", "hyundai", "ibm", "ideal", "ideal-standard", "indesit", "infinix", "intel-inside", "iphone", "isadora", "isuzu", "j-b-l", "janssen", "jeep", "jotun", "kapci", "kelvinator", "kenwood", "kia", "kiriazi", "korloff-paris", "lacoste", "lada", "lancer", "legrand", "lenovo", "lg", "man", "mazda", "mercedes", "mercedes_benz", "michelin", "microsoft", "miele", "mitsubishi", "mobinil", "momma", "mont-blanc", "motorola", "moulinex", "nasa", "national", "nec", "nike", "nikon", "nissan", "nokia", "octavia", "olympic", "opel", "oppo", "optra-", "pachin", "panasonic", "perkins", "persol", "peugeot", "philips", "pierre-cardin", "pirelli", "police", "prada", "puma", "ray-ban", "ray_ban", "rca", "reebok", "renault", "ricoh", "salvatore-ferragam", "samsung", "samsung-mobile", "schneider-electric", "scib", "seat", "sharp", "siemens", "sipes", "skoda", "sony", "sony-ericsson", "speranza", "suzuki", "thomson", "tornado", "toscana", "toshiba", "total", "toyota", "toyota-corolla", "trane", "transocean", "ultra", "unionaire", "universal", "varta", "vega", "versace", "vodafone", "vogue", "volkswagen", "volvo", "western-union", "westinghouse", "white-westinghouse", "white-whale", "xerox", "yamaha", "york", "zanussi" ], "type": "string", "description": "Brand to browse (mode=byBrand). Pick from the most popular Egypt Yellow Pages brands, or choose 'Custom brand' and type your own slug below.", "default": "toyota" }, "customBrand": { "title": "Custom brand (overrides selection above)", "type": "string", "description": "Free-text brand slug, e.g. 'toyota' or 'samsung' (mode=byBrand). Find the slug by browsing https://yellowpages.com.eg/en/related-brands and copying the URL segment after /en/brand/. Takes priority over 'Brand' when set." }, "keyword": { "title": "Keyword/tag (mode=byKeyword)", "type": "string", "description": "Tag/keyword slug to browse (mode=byKeyword), e.g. 'dentist' or 'pizza'. Every business listing carries its own keyword tags (visible in the `keywords` output field of any other mode) -- browsing by one of those tags returns every business tagged with it, which is broader than a category and more specific than a free-text search. Find slugs from the `keywords` field of prior results, or from the URL segment after /en/keyword/ when browsing the site.", "default": "dentist" }, "businessUrls": { "title": "Business URLs (mode=byUrls)", "type": "array", "description": "Direct yellowpages.com.eg business profile URLs to fetch, e.g. https://yellowpages.com.eg/en/profile/some-business/12345. Use the 'sourceUrl' field from search/category results.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "yellowpages.com.eg business profile URL." } } }, "default": [] }, "language": { "title": "Language", "enum": [ "en", "ar" ], "type": "string", "description": "Site locale to scrape from. English returns Latin-script text; Arabic returns the business's native Arabic listing (fully supported, valid UTF-8 output). Applies to all modes.", "default": "en" }, "governorate": { "title": "Governorate filter", "enum": [ "", "cairo", "giza", "alexandria", "qalyubia", "dakahlia", "sharkeya", "gharbeya", "monofeya", "beheira", "kafr-el-sheikh", "damietta", "port-said", "ismailia", "suez", "fayoum", "beni-suef", "minya", "asyut", "sohag", "qena", "luxor", "aswan", "red-sea", "hurghada", "south-sinai", "sharm-el-sheikh", "north-sinai", "matrouh", "new-valley" ], "type": "string", "description": "Only return businesses located in this Egyptian governorate (applies to any mode). Leave as 'All governorates' for nationwide results. Matched against the business's published address.", "default": "" }, "requireWebsite": { "title": "Require website", "type": "boolean", "description": "Only return businesses that have a website listed on their Yellow Pages profile.", "default": false }, "requirePhone": { "title": "Require phone number", "type": "boolean", "description": "Only return businesses that have a phone number listed on their Yellow Pages profile.", "default": false }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only return businesses rated at least this many stars (1-5). 0 means no minimum. Businesses with no rating are excluded once this is set above 0.", "default": 0 }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on the 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 } } } } } } } } } } ```