📞 Telecontact Scraper - Morocco Business Leads (Pages Jaunes Maroc)

Extract business leads from Telecontact.ma, the Moroccan yellow pages (Pages Jaunes Maroc). Search any trade or category in any city, or all of Morocco. For each business you get its phones in international format, fax, WhatsApp, website, street address, city, map position, and the company data Telecontact publishes: ICE number, trade register (RC), legal form, share capital, staff range, founding year and managers. You also get categories, products and services, opening hours, other branches, photos, reviews and social media links. Turn on the email add-on to collect emails from each business's own website. It collects 1,000 businesses in under a minute, gets past the site's 100-results-per-list limit, and can run on a schedule to send you only new businesses.

🎯 Who uses it?

📞 Sales teams and lead generation agencies

Build call lists of Moroccan businesses by trade and city, with mobile numbers and WhatsApp, ready for your CRM.

🏦 B2B, banks and compliance teams

Check companies with their ICE, RC number and city, legal form, capital, size and founding year.

📣 Marketing agencies

Find businesses with no website or social media in a city, and offer them yours.

📊 Market researchers

Count and map businesses by category, city, legal form, size and age, with map positions.

✨ What it does

• Search like on the site. Type a trade or category in French ("restaurant", "plombier", "avocat", "pharmacie"), with several terms in one run. Each term covers every matching category: "restaurant" also searches "Restaurants: cuisine marocaine", "Restaurants: cuisine italienne" and the rest.
• Any city, or all of Morocco. Type cities ("Casablanca", "Fès", "El Jadida"), or leave them empty to search the whole country. A city with no search term gives every business in that city.
• No 100-results cut-off. The site shows at most 100 businesses per list. Bigger searches are also read sub-category by sub-category and city by city, so you get far more.
• Or paste links. Use category pages or business pages from telecontact.ma. Filters are ignored with links.
• Filters: only businesses with a phone, mobile phone, WhatsApp, website, email, social media, ICE number or map position, only paid listings, legal forms, company size, founding years, and open on chosen days.
• Email add-on: opens each business website (home page, then its contact page) and collects the email addresses shown there. Telecontact itself shows no emails.
• Monitoring: run it on a schedule with Only new businesses, and each run saves only businesses you haven't received yet.

🏆 Why this scraper

• Fast. 1,000 businesses with full business pages in under a minute.
• Company data, not only contacts. ICE, RC number and city, legal form, capital in MAD, staff range, founding year and managers, each in its own field.
• Phones ready to dial. Every phone, fax and WhatsApp number is in international format (+212...), and the fake "00 00 00 00 00" numbers are removed.
• On-topic results. Paid listings that the site shows above unrelated searches are left out.
• Clean, typed data. Map positions, capital and years are numbers, days are in English, hours are in 24h format, and there are no HTML leftovers.
• Nothing to set up. A proxy is used automatically, with no extra cost to you.

⚖️ How it compares

Based on each Actor's public input options, README and output fields (October 2026).

Capability	This actor	memo23
Businesses per search	every sub-category and city (thousands)	up to 100 (site limit)
Search term finds every matching category	yes	no (one search)
Category pages and business page links	yes	yes
ICE, RC number, legal form, capital, staff range, founding year	yes	no
Managers, categories, products and services	yes	no
Fax, WhatsApp and social media links	yes	no
Other branches, photos, reviews and rating	yes	no
Off-topic paid listings left out	yes	no
Phone, mobile, WhatsApp, website, email, social, ICE and map filters	yes	no
Legal form, company size, founding year and opening day filters	yes	no
Only new businesses (monitoring)	yes	no
Emails taken from the business's own website	yes	yes
Fields per business	45	about 14
Extra charge per phone or email found	no (emails only with the add-on)	yes

📦 What data you get

Field	Description
imageUrl	Business logo (paid listings only).
name	Business name.
description	Short description of the business.
searchTerm, searchLocation	The search term and city that found it (empty with links).
phone	Main phone in international format (+212...).
fax	Fax number.
whatsapp	WhatsApp number.
address	Street address.
postalCode	Postal code, when shown.
city	City.
latitude, longitude	Map position.
legalForm	Legal form (SARL, SARL AU, SA, Entreprise individuelle...).
capitalMad	Share capital in Moroccan dirhams.
employees	Staff range, like "10-19".
foundedYear	Year the business was founded.
ice	ICE number (Identifiant Commun de l'Entreprise).
tradeRegisterNumber, tradeRegisterCity	Trade register (RC) number and the city where it is registered.
rating, reviewCount	Average review rating and number of reviews.
id	Telecontact's ID for the business.
isAdvertiser	True for paid Telecontact listings.
url	Business page on Telecontact.
website	Business's own website.
facebook, instagram, linkedin, youtube, twitter, tiktok	Social media profiles.
videoUrl	Presentation video.
phones	Every phone number on the business page.
emails	(Emails) Email addresses found on the business website.
managers	Managers and directors named on the page.
categories	Every category the business is listed under.
services	Products and services offered.
openingHours	Opening hours: day (Monday to Sunday), opens and closes (24h).
otherAddresses	Other branches: name, city, label, address, phone and page link.
photos	Photo links.
reviews	Reviews: author, date, rating and text.
updatedAt	When the business last updated its listing (paid listings).
scrapedAt	When this row was saved.
error	Only on rows whose business page could not be read.
error	Only present when a row failed. The fields that loaded are still there.

Fields marked Emails only appear when that add-on is on.

Example row (trimmed)

{
  "name": "Le pavillon",
  "description": "Le pavillon est une SARL créée en 2003, active dans le secteur « Restaurants (cuisine française) » à Marrakech. Elle compte entre 10 et 19 salariés et est dirigée par Mme Debois Froge Catherine.",
  "searchTerm": "restaurant",
  "searchLocation": "Marrakech",
  "phone": "+212524387040",
  "fax": "+212524380928",
  "address": "47 Derb Zaouia, Bab Doukkala",
  "city": "Marrakech",
  "latitude": 31.6257,
  "longitude": -7.994183,
  "legalForm": "SARL",
  "capitalMad": 100000,
  "employees": "10-19",
  "foundedYear": 2003,
  "ice": "000070790000055",
  "tradeRegisterNumber": "16591",
  "tradeRegisterCity": "Marrakech",
  "reviewCount": 0,
  "id": "2139022",
  "isAdvertiser": false,
  "url": "https://www.telecontact.ma/annonceur/le-pavillon/2139022/marrakech.php",
  "phones": ["+212524387040"],
  "managers": ["Mme Debois Froge Catherine"],
  "categories": ["Restaurants (cuisine française)"],
  "scrapedAt": "2026-10-17T20:44:48.723Z"
}

💡 Use cases

Every restaurant in Casablanca and Rabat with a mobile number:

{
  "searchTerms": ["restaurant"],
  "locations": ["Casablanca", "Rabat"],
  "onlyWithMobile": true,
  "maxItems": 1000
}

Established companies (SARL, SA) with an ICE number, all of Morocco:

{
  "searchTerms": ["transport"],
  "onlyWithIce": true,
  "legalForms": ["SARL", "SA"],
  "foundedTo": 2015
}

Every business in a city:

{
  "locations": ["Ifrane"]
}

Lawyers with emails from their websites:

{
  "searchTerms": ["avocat"],
  "locations": ["Marrakech"],
  "onlyWithEmail": true
}

New pharmacies every week (schedule this run):

{
  "searchTerms": ["pharmacie"],
  "onlyNew": true,
  "monitorName": "pharmacies-maroc"
}

Links (filters are ignored):

{
  "startUrls": [
    { "url": "https://www.telecontact.ma/liens/restaurants/casablanca.php" },
    { "url": "https://www.telecontact.ma/maroc/pharmacies.html" }
  ]
}

⚙️ How the input is organised

Section	What it's for
Maximum results	Always first, caps the whole run. Empty means no limit.
What to scrape	Search terms, cities and emails from the business website.
Filters	Only with phone, only with mobile phone, only with WhatsApp, only with website, only with email, only with social media, only with ICE number, only with map position, only advertisers, legal forms, company size (employees), founded from (year), founded until (year) and open on these days.
Monitoring	Only new businesses and monitor name.
Links	Links instead of the fields above. Filters are ignored with links.

💰 Pricing

Pay-per-event: a one-time $0.003 when the run starts, plus a price per business saved to your dataset. The price depends on your Apify plan tier:

Your Apify plan	Price per business
Free	$0.013
Bronze	$0.012
Silver	$0.011
Gold / Platinum / Diamond	$0.010

Approximate total cost:

Businesses collected	Free	Bronze	Silver	Gold+
100	$1.30	$1.20	$1.10	$1.00
1,000	$13.00	$12.00	$11.00	$10.00
10,000	$130.00	$120.00	$110.00	$100.00

Email add-on: when Emails from the business website is on (or Only with email turns it on), each business saved with at least one email adds one more charge:

Your Apify plan	Emails, per business with emails
Free	$0.004
Bronze	$0.0035
Silver	$0.003
Gold / Platinum / Diamond	$0.0025

Businesses where no email was found pay only the base price, and businesses left out by filters are free. Proxy costs are included. New Apify accounts start with $5 in free credit. On the Free plan, a run saves up to 10 businesses.

🚀 Run it

1. Create a free Apify account with $5 in credit.
2. Open the Telecontact Scraper.
3. Type search terms and cities (or keep the prefilled ones), add filters, then click Start.
4. Export the results as CSV, Excel, JSON or XML from the Dataset tab.

🤖 Use with AI agents (MCP)

Connect the Apify MCP server to Claude, ChatGPT, Cursor or any MCP client, then ask in plain words, for example: "Find 200 plumbers in Casablanca with a mobile number on Telecontact". The agent runs this Actor and reads the results.

🔧 Troubleshooting

• Few or no results. Telecontact searches in French, so try "avocat" instead of "lawyer". The log shows which categories a term matched, and suggests close names when nothing matched.
• A city was skipped. The log says when the site doesn't know a city, with close names. Check the spelling ("Fès" or "Fes" both work).
• Few websites, WhatsApp numbers or emails. Most free listings only carry a name, phone, address and company data. Use the Only with website or Only with WhatsApp filters.
• Some company fields are empty. Not every business publishes its ICE, capital, staff range or founding year. Fields the page doesn't show are empty.

❓ FAQ

Is there a limit per search? The site shows at most 100 businesses per category and city. This Actor also reads every matching sub-category, and for nationwide searches every city, so a search returns far more.

Can I search all of Morocco? Yes. Leave cities empty. The national list is read first, then city by city, biggest cities first, until Maximum results is reached.

Why are there no emails without the add-on? Telecontact doesn't publish business emails, only a contact form. The add-on reads them from each business's own website.

Do I need a proxy? No. The Actor uses one automatically, included in the price.

🛡️ Limits & responsible use

This Actor collects business information that businesses publish on Telecontact.ma. It reads only the pages the site's robots.txt allows (category and business pages, not the search engine). Use the data in line with the site's terms, Moroccan data protection law (Law 09-08, CNDP) and anti-spam rules, especially for phone, WhatsApp and email outreach.

📧 Contact

Questions, bugs or a field you need: norm.data.scrapers@gmail.com

🧪 Local development

bun install
bun scripts/gen-schemas.mjs
sh test/run.sh first '{"maxItems":10,"searchTerms":["restaurant"],"locations":["Casablanca"]}'