{ "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 } } } } } } } } } }