Jordan Business Directory Scraper (JordanYP)

Scrape JordanYP (jordanyp.com), Jordan's largest online business directory with 47,000+ verified listings. Search by keyword, browse any of 300+ business categories or 20 Jordanian cities, or look up specific businesses by profile URL / ID. Get phone numbers, mobile numbers, addresses, websites, working hours, manager names, establishment year, employee count, review ratings, GPS coordinates, and photos - ready for lead generation, market research, or building a local business dataset for Jordan.

No login, no cookies, no paid proxies required.

What this actor does

• Keyword search - search JordanYP the same way a visitor would, optionally narrowed to a specific city
• Category browsing - pull every business listed under any of 300+ categories (Lawyers, Restaurants, Hotels, Doctors & Clinics, Construction Services, Car Dealers, and hundreds more), optionally narrowed to a city
• City browsing - pull every business listed in any of Jordan's 20 covered cities (Amman, Irbid, Aqaba, Zarqa, Madaba, and more)
• Direct lookup - fetch specific businesses by pasting their JordanYP profile URL or numeric ID
• Rich filters - verified-only, has-website, minimum rating, minimum review count, establishment-year range, and a name/description keyword filter
• Deduplication - the same business is never emitted twice, even across pages or overlapping filters
• Clean output - every field is real data pulled from the live page; fields the source doesn't provide for a given business are simply omitted (never null, "", or placeholder text)

Output fields

Each item in the dataset represents one business:

Field	Description
companyId	JordanYP's internal numeric business ID
name	Business name
tagline	Short one-line business summary
description	Full business description
city	City in Jordan
address	Full street address
country	Always Jordan
phone	Primary contact number
mobilePhone	Mobile contact number (when listed)
website	Business website (resolved to the real external URL)
companyManager	Listed company manager / owner name
establishmentYear	Year the business was established
employees	Employee count range (e.g. 1-5, 11-50)
workingHours	Opening hours per day of the week
categories	JordanYP categories the business is listed under
verified	Whether JordanYP has verified this listing
yearsListed	How many years the business has been listed on JordanYP
recentlyUpdated	Whether the listing was recently refreshed by its owner
reviewCount	Number of JordanYP reviews
rating	Average review rating (0-5), only present when reviewCount > 0
latitude / longitude	GPS coordinates (when the business has a map pin)
logoImageUrl	Main business photo/logo
photoUrls	All gallery photos for the business
registeredAt	When the listing was first registered on JordanYP
lastUpdatedAt	When the listing was last updated
sourceUrl	Canonical JordanYP profile URL
scrapedAt	UTC timestamp of when the record was scraped
recordType	Always business

Input options

Field	Type	Description
mode	select	search, byCategory, byCity, or byUrls
searchQuery	string	Free-text keyword (mode=search), e.g. restaurant, lawyer, hotel
city	select	One of 20 Jordanian cities. Required for byCity; optional narrowing filter for search/byCategory
category	select	One of 300+ business categories. Required for byCategory
companyUrls	array	JordanYP profile URLs or bare numeric IDs (mode=byUrls)
verifiedOnly	boolean	Only emit JordanYP-verified businesses
hasWebsite	boolean	Only emit businesses that list a website
minRating	number	Drop businesses with a review rating below this (0-5)
minReviews	integer	Drop businesses with fewer reviews than this
minEstablishmentYear	integer	Drop businesses established before this year
maxEstablishmentYear	integer	Drop businesses established after this year
containsKeyword	string	Case-insensitive substring filter on name/tagline/description
maxItems	integer	Hard cap on emitted records (1-300)

Example inputs

Search for restaurants in Amman

{
  "mode": "search",
  "searchQuery": "restaurant",
  "city": "Amman",
  "maxItems": 50
}

Every verified lawyer in Amman

{
  "mode": "byCategory",
  "category": "lawyers",
  "city": "Amman",
  "verifiedOnly": true,
  "maxItems": 100
}

All businesses in Irbid with a website listed

{
  "mode": "byCity",
  "city": "Irbid",
  "hasWebsite": true,
  "maxItems": 100
}

Look up specific businesses by URL or ID

{
  "mode": "byUrls",
  "companyUrls": [
    "https://www.jordanyp.com/company/373584/Arida_Law_Firm",
    "349701"
  ]
}

Use cases

• Lead generation - build targeted contact lists of Jordanian businesses by category and city
• Market research - analyze business density, categories, and coverage across Jordan's cities
• Competitive analysis - pull every competitor listed in a category, with ratings and review counts
• Data enrichment - attach verified phone numbers, websites, and coordinates to an existing business dataset
• Local SEO / directory audits - check how a business (or its competitors) appears on JordanYP

FAQ

Do I need a JordanYP account, API key, or proxy? No. This actor works with plain, public pages - no login, cookies, or paid proxy configuration needed.

Why are some fields missing from certain businesses? JordanYP listings are self-reported by business owners, so not every business lists a mobile number, working hours, establishment year, or photos. This actor only includes fields that are actually present on the source page - it never fabricates placeholder values.

Why don't some businesses have a rating field? rating is only included when the business has at least one review (reviewCount > 0). Businesses with zero reviews still include reviewCount: 0 but omit rating, since there's no genuine rating signal yet.

Can I search in Arabic? Yes - searchQuery accepts Arabic (or any Unicode) text and is passed straight through to JordanYP's own search.

Does city restrict byCategory results to only that city? Yes. When both category and city are set, results are narrowed to businesses in that category and that city.

What happens if a filter combination matches nothing? The run finishes cleanly with zero items and a status message explaining why (e.g. "no results" or "try widening filters") - it won't error out.

Why is there no email field? JordanYP gates each business's e-mail address behind a "Show Email" sign-in action - it is never present in the public page markup, so it can't be reliably scraped without a logged-in session. This actor stays login-free by design, so email is intentionally excluded. phone, mobilePhone, and website remain fully available.