Telecontact Morocco Scraper

Scrape telecontact.ma into one row per business: name, phone, website, address, coordinates, hours.

Works from a category plus optional city, or a pasted search or profile URL. Direct requests return the HTML. No proxy by default.

Pricing: $0.005 per listing (pushData). Extra contact-phone $0.002 and contact-email $0.05 when those fields are present.

Why use this scraper?

• Search cards carry the name, street, city, and profile link. The profile adds the phone, website, coordinates, and hours.
• A city is the ou slug: restaurant in casablanca. Nationwide leaves the city empty.
• Page 2 is the same search with &page=2 (20 cards). It does not repeat page 1.
• The directory inbox (@telecontact.ma, @edicom.ma) is dropped. Email comes from the business website when harvest is on.

Overview

Built for lead lists on Moroccan companies. The phone sits in the profile HTML (tel:), including the numbers behind “Afficher le téléphone”.

Supported inputs

Input	What it does
startUrls	Search URL or /annonceur/{slug}/{id}/{city}.php
searchTerms	Category, e.g. restaurant
locations	City slug, e.g. casablanca. Empty = nationwide
maxItems	Stop after N unique listings (free plan cap 50)
maxPages	20 cards per page
harvestWebsiteEmail	Fetch the business site when the directory has no inbox
proxy	Off by default

Use cases

Who	Why
Sales / agencies	Moroccan phones from a category
Researchers	City, street, and hours
SEO	Website and coordinates per listing

How it works

1. Open https://www.telecontact.ma/trouver/index.php?nxo=moteur&nxs=process&string={category}&ou={city}.
2. Parse [data-code-firme] cards and their /annonceur/ profile links.
3. Follow &page= for the next 20 cards.
4. Open each profile for phone, website, coordinates, and hours.
5. Charge contact-phone / contact-email after pushData.

Input configuration

Field	Type	Required	Notes
startUrls	url[]	one of terms/URLs	search or profile
searchTerms	string[]	one of terms/URLs	e.g. restaurant
locations	string[]	no	e.g. casablanca
maxItems	integer	no	default 50
maxPages	integer	no	default 20
scrapeDetails	boolean	no	default true
harvestWebsiteEmail	boolean	no	default true
maxConcurrency	integer	no	default 5
proxy	proxy	no	default off

Example input

{
  "searchTerms": ["restaurant"],
  "locations": ["casablanca"],
  "maxItems": 10,
  "harvestWebsiteEmail": false,
  "proxy": { "useApifyProxy": false }
}

Output overview

One JSON object per business. The phone, website, coordinates, and hours come from the profile.

Output samples

{
  "listingId": "2161629",
  "name": "CASAPACKING",
  "phone": "0522444423",
  "phones": ["0522444423", "0660610944"],
  "website": "https://casapacking.com/LeM/",
  "street": "100 bd Abdellah Ben Yacine Belvedere",
  "city": "Casablanca",
  "country": "MA",
  "latitude": 33.590204,
  "longitude": -7.600874,
  "hours": ["Mon 08:00-12:00, 14:00-18:00"],
  "profileUrl": "https://www.telecontact.ma/annonceur/casapacking/2161629/casablanca.php",
  "source": "telecontact"
}

FAQ

Does a city filter work? Yes. ou=casablanca is a different set from a nationwide search. Some Casablanca firms still appear in the nationwide page.

Is there a page 2? Yes. &page=2 is 20 new cards. The pager is 1-based.

Where is the email? Not on the card or the profile. Turn on website harvest if you want an inbox from the business site.

Do I need a proxy? No. Leave it off unless a run starts getting blocked.

Support

Questions or a broken selector: open an issue on the actor page.

Disclaimer

Use this actor in line with telecontact.ma terms and applicable law. You are responsible for how you use the data.