yellowpages-uae.com APIyellowpages-uae.com ↗
Search UAE businesses, get contact details, coordinates, and branch locations from Yellow Pages UAE via 5 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/09009da5-f713-40fe-8d6f-5f4de09b59e5/search_businesses?category=Restaurants&location=Dubai' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for businesses by category and location in the UAE. Returns a paginated list of results with contact details and category tags.
| 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 names 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 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=...",
"city": "Dubai",
"logo": "https://media.yellowpages-uae.com/wfile/webplogo/300762.webp",
"name": "Miyabi Sushi & Bento",
"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 yellowpages-uae.com 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.
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.
- 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 | 250 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.