# Telecontact — 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.

> Find businesses, phone numbers, and reviews across Morocco using Telecontact.ma's comprehensive directory—search by business name, location, phone number, brand, or ICE registration, and access detailed contact information, ratings, and top-rated companies in any category. Discover local services, browse by activity type, and identify leading brands all in one place.

**Category:** Business Directories | **Website:** [telecontact.ma/](https://telecontact.ma/) | **Docs:** [parse.bot/marketplace/dcfd45d6-dea9-4c7e-89b8-24cd95c68e2a/telecontact-ma-api](https://parse.bot/marketplace/dcfd45d6-dea9-4c7e-89b8-24cd95c68e2a/telecontact-ma-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-telecontact-ma-api-dcfd45d6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_category

Browse all businesses in a given activity category nationwide. Categories use URL slugs (e.g., 'restaurants', 'cliniques'). Returns 20 results per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category slug (e.g., restaurants, climatisation, cliniques) |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telecontact-ma-api-dcfd45d6/browse_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","page":"<integer>"}'
```

### get_listing_detail

Fetch full details for a single business listing including contact information, activities, legal data (ICE, RC), director name, and geolocation. Requires the listing URL obtained from any search endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full listing URL from search results (e.g., https://www.telecontact.ma/annonceur/ink-services/2228915/casablanca.php) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telecontact-ma-api-dcfd45d6/get_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_listing_reviews

Fetch customer reviews and ratings for a specific listing. Returns individual reviews with author, content, rating, and date, plus aggregate statistics. Requires the listing URL from search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full listing URL from search results (e.g., https://www.telecontact.ma/annonceur/6eme-symphonie/3244725/rabat.php) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telecontact-ma-api-dcfd45d6/get_listing_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_top_activities

List all business activity categories on the platform. Each activity has a name and URL. Extract the slug from the URL to use with browse_category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telecontact-ma-api-dcfd45d6/get_top_activities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_top_brands

List all brands referenced on the platform. Each brand has a name and URL. Brand names can be used with search_by_brand.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telecontact-ma-api-dcfd45d6/get_top_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_by_brand

Search for businesses by brand they carry or represent. Returns dealers, distributors, and service centers for the given brand.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Brand name (e.g., samsung, lg, bosch) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telecontact-ma-api-dcfd45d6/search_by_brand \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>"}'
```

### search_by_city

Search businesses within a specific Moroccan city by keyword. Filters results to the named city. Returns 20 results per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name (e.g., casablanca, rabat, marrakech) |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (activity, business name, etc.) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telecontact-ma-api-dcfd45d6/search_by_city \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","page":"<integer>","query":"<string>"}'
```

### search_by_ice

Look up a business by its ICE (Identifiant Commun de l'Entreprise) tax identification number. Returns the single matching business if found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ice` | string | Yes | ICE number (15 digits, e.g., 000084981000048) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telecontact-ma-api-dcfd45d6/search_by_ice \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ice":"<string>"}'
```

### search_by_phone

Reverse phone/fax number lookup. Returns businesses associated with the given phone number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `phone` | string | Yes | Phone or fax number (e.g., 0522234567) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telecontact-ma-api-dcfd45d6/search_by_phone \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"<string>"}'
```

### search_national

Full-text search across all Moroccan businesses. Matches query against business names and activities nationwide. Returns 20 results per page; paginate via the page parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (activity, business name, etc.) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telecontact-ma-api-dcfd45d6/search_national \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```