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

{
  "mode": "search",
  "query": "restaurants",
  "maxItems": 20
}

Example: browse dentists in Cairo with at least a 4-star rating

{
  "mode": "byCategory",
  "category": "dentists",
  "governorate": "cairo",
  "minRating": 4,
  "maxItems": 30
}

Example: Toyota dealers with a published website and phone number

{
  "mode": "byBrand",
  "brand": "toyota",
  "requireWebsite": true,
  "requirePhone": true,
  "maxItems": 50
}

Example: browse every business tagged "pizza"

{
  "mode": "byKeyword",
  "keyword": "pizza",
  "maxItems": 30
}

Example: fetch specific businesses by URL, in Arabic

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