Yellow Pages UAE APIyellowpages-uae.com ↗
Search UAE businesses, get contact details, coordinates, and branch locations from Yellow Pages UAE via 5 structured API endpoints.
What is the Yellow Pages UAE API?
The Yellow Pages UAE API provides access to business listings, contact details, geolocation coordinates, and branch data from the UAE's Yellow Pages directory across 5 endpoints. Use search_businesses to query companies by category and emirate, get_business_detail to retrieve full profiles including latitude, phone, and PO box, or get_business_branches to enumerate all locations for multi-branch operators across Dubai, Abu Dhabi, and other UAE cities.
curl -X GET 'https://api.parse.bot/scraper/09009da5-f713-40fe-8d6f-5f4de09b59e5/search_businesses?page=1&category=restaurants&location=uae' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace yellowpages-uae-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.yellow_pages_uae_api import YellowPagesUAE, BusinessSummary, Business, Suggestion, City, SuggestionType, Location
yp = YellowPagesUAE()
# List available cities
for city in yp.cities.list():
print(city.name, city.slug)
# Search for restaurants in Dubai using the Location enum
for listing in yp.businesssummaries.search(category="restaurants", location=Location.DUBAI, limit=5):
print(listing.name, listing.city, listing.phone)
# Get full details for the listing
detail = listing.details()
print(detail.latitude, detail.longitude, detail.website_url)
# Get branches
for branch in detail.branches.list():
print(branch.location, branch.city, branch.phone)
break
# Search suggestions and filter by type
for suggestion in yp.suggestions.search(query="hotel"):
if suggestion.type_code == SuggestionType.CATEGORY:
print(suggestion.name, suggestion.url)
Search for businesses by category and location in the UAE. Returns a paginated list of results with contact details and category tags. Categories are URL-slugified (e.g. 'Restaurants' becomes 'restaurants'). Pagination via page number; each page returns ~25 listings. Results include phone, mobile, address, and product/service tags for each listing.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| categoryrequired | string | Business category to search for. Value is converted to a URL slug (e.g., 'Restaurants' becomes 'restaurants', 'Advertising' becomes 'advertising'). |
| location | string | City or emirate to filter by. Accepts city slugs like 'dubai', 'abu-dhabi', or 'uae' for all. Omitting returns results across all UAE locations. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"listings": "array of business listing objects with slug, id, name, url, logo, location, city, po_box, phone, mobile, products_services, branches_url, directions_url, website_url",
"results_count": "string describing total results and category context"
},
"sample": {
"data": {
"page": 1,
"listings": [
{
"id": "153749",
"url": "https://www.yellowpages-uae.com/miyabi-sushi-bento-153749?p=U2FsdGVkX189yafsbRwTBixYNzaonxCBA3NpvpoQpBM%253D",
"city": "Dubai",
"logo": "https://media.yellowpages-uae.com/wfile/webplogo/300762.webp",
"name": "Miyabi Sushi & Bento",
"slug": "miyabi-sushi-bento-153749",
"phone": "+1 (555) 012-3456,800MIYABI",
"mobile": "+1 (555) 012-3456",
"po_box": "391073",
"location": "Next to Four Points by Sheraton, Behind UAE Exchange, Sh Zayed Road",
"website_url": "https://www.miyabisushidubai.com",
"branches_url": "https://www.yellowpages-uae.com/branches/miyabi-sushi-bento-300762",
"directions_url": "https://www.google.com/maps/dir/?api=1&destination=25.21389,55.27564",
"products_services": [
"Restaurants",
"Japanese Restaurants",
"Korean Restaurants"
]
}
],
"results_count": "798results forRestaurants In Dubai | Budget Friendly, Drive In And More"
},
"status": "success"
}
}About the Yellow Pages UAE API
What the API Covers
The Yellow Pages UAE API surfaces structured business data from yellowpages-uae.com. The search_businesses endpoint accepts a required category string (converted internally to a URL slug) and an optional location parameter accepting emirate or city names like Dubai or Abu Dhabi, or uae for directory-wide results. Responses include paginated arrays of listing objects containing id, name, phone, mobile, po_box, location, city, logo, and a branches_url field that points to multi-location groups when applicable.
Business Profiles and Branch Data
get_business_detail takes a slug_or_id (formatted as business-name-123456) and returns the full profile for a single business, including latitude when the source carries coordinates, street-level location, city, and contact fields. For chains and franchises, get_business_branches accepts the group slug from branches_url and returns an array of branch objects each containing id, name, phone, mobile, location, city, directions_url, and website. The total_branches integer tells you upfront how many locations exist.
Discovery and Location Utilities
get_search_suggestions accepts a partial query string and returns up to 10 suggestion objects, each with a Name, a URL slug, and a Type integer distinguishing categories (1) from specific business names (3). This makes it practical to build autocomplete flows before committing to a full search_businesses call. list_cities requires no inputs and returns the 8 supported UAE cities and emirates with both display name and slug values ready to pass into the location parameter.
The Yellow Pages UAE API is a managed, monitored endpoint for yellowpages-uae.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when yellowpages-uae.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official yellowpages-uae.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a UAE business finder that filters by category and emirate using
search_businesseswith thelocationandcategoryparams - Enrich a CRM with verified phone, mobile, and PO box data pulled from
get_business_detail - Plot business locations on a map using
latitudeandlocationfields from the detail endpoint - Identify all branch addresses for a retail chain using
get_business_branchesand thebranches_urlgroup ID - Implement autocomplete search using
get_search_suggestionsto surface matching categories and business names from partial queries - Audit UAE market presence in a given vertical by paginating through
search_businessesresults and counting unique operators - Compile a city-by-city supplier list using
list_citiesslugs to iterate through all supported UAE locations
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Yellow Pages UAE offer an official developer API?+
What distinguishes the results from `get_business_detail` versus `search_businesses`?+
id, name, phone, mobile, po_box, city, logo, and branches_url — sufficient for list views. The detail endpoint adds latitude, the full street-level location, and a complete URL, making it the right call when you need geocoordinates or a precise address for a single business.Does the API return longitude coordinates alongside latitude?+
get_business_detail endpoint exposes a latitude field when the source carries it, but longitude is not a documented response field in the current API. The API covers id, name, phone, mobile, po_box, city, location, and latitude. You can fork it on Parse and revise to add longitude extraction if the source exposes it for specific listings.Are business reviews or ratings available from any endpoint?+
How does pagination work in `search_businesses`?+
page parameter. Each response includes the current page number and a results_count string describing the total results in context. You increment page to step through results; there is no cursor or token-based pagination.