# Yellowpages Uae — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and discover UAE businesses with instant access to contact details, locations, and branch information from the Yellow Pages UAE directory. Find companies by name, get detailed business profiles, explore multiple branches, and browse available cities all in one place.

**Category:** Business Directories | **Website:** [yellowpages-uae.com/](https://yellowpages-uae.com/) | **Docs:** [parse.bot/marketplace/0e7aab13-cc8c-4673-9a2c-01f06a4b8ab8/yellowpages-uae-com-api](https://parse.bot/marketplace/0e7aab13-cc8c-4673-9a2c-01f06a4b8ab8/yellowpages-uae-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-yellowpages-uae-com-api-0e7aab13/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_business_branches

Get all branch locations for a multi-location business. Uses the group ID found in the branches_url from search results. Each branch includes its own contact details, address, and directions link.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug_or_id` | string | Yes | Business slug with group ID from the branches_url field in search results (e.g., 'miyabi-sushi-bento-300762'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yellowpages-uae-com-api-0e7aab13/get_business_branches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug_or_id":"<string>"}'
```

### get_business_detail

Get full details for a specific business by its slug and ID. Returns contact information, address, coordinates, and associated services. The slug_or_id is the business identifier as found in search results URL (e.g. 'miyabi-sushi-bento-153749').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug_or_id` | string | Yes | Business slug with ID as found in search results (e.g., 'miyabi-sushi-bento-153749'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yellowpages-uae-com-api-0e7aab13/get_business_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug_or_id":"<string>"}'
```

### get_search_suggestions

Get keyword search suggestions for a partial search term. Returns up to 10 suggestions including category names and business names. Each suggestion has a Name, URL slug, and Type code (1 for category, 2 for brand/keyword, 3 for business name).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial search term to get suggestions for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yellowpages-uae-com-api-0e7aab13/get_search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### list_cities

List all supported UAE cities and emirates for location-filtered searches. Returns 8 entries including a UAE-wide option. The slug values can be passed directly to the search_businesses location parameter.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yellowpages-uae-com-api-0e7aab13/list_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_businesses

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Business category to search for. Value is converted to a URL slug (e.g., 'Restaurants' becomes 'restaurants', 'Advertising' becomes 'advertising'). |
| `location` | string | No | City or emirate to filter by. Accepts city slugs like 'dubai', 'abu-dhabi', or 'uae' for all. Omitting returns results across all UAE locations. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-yellowpages-uae-com-api-0e7aab13/search_businesses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","location":"<string>","page":"<integer>"}'
```