telecontact.ma APItelecontact.ma ↗
Search and retrieve Moroccan business listings from telecontact.ma. Look up by keyword, city, phone, brand, or ICE number. Access contacts, reviews, and geolocation.
curl -X GET 'https://api.parse.bot/scraper/eb802322-1c0c-436a-9168-97eba09d3517/search_national?page=1&query=hotels' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for businesses nationwide by keyword. Returns paginated results with 20 items per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (activity, business name, etc.) |
{
"type": "object",
"fields": {
"total": "integer total number of results",
"results": "array of business objects with name, url, city, and summary"
},
"sample": {
"data": {
"total": 20,
"results": [
{
"url": "https://www.telecontact.ma/annonceur/best-diffusion/2183726/casablanca.php",
"city": "Casablanca",
"name": "Best Diffusion",
"summary": "Best Diffusion ... Protection et sécurité du travail (matériel)"
}
]
},
"status": "success"
}
}About the telecontact.ma API
The Telecontact.ma API covers 10 endpoints for querying Morocco's largest business directory, returning structured data on company names, addresses, phone numbers, ICE tax identifiers, and geolocation. Use search_national to run a keyword search across all cities and get paginated results, or drill into a specific listing with get_listing_detail to retrieve fields like director name, latitude/longitude, email, RC registration number, and business website.
Search Methods
Five search endpoints let you find businesses using different identifiers. search_national and search_by_city both accept a query string (business name, activity type, etc.) and return up to 20 results per page with name, url, city, and summary fields. search_by_city narrows results to a single city such as casablanca or marrakech. search_by_phone performs reverse lookup against a phone or fax number. search_by_brand finds businesses that carry a given brand (e.g., samsung, bosch). search_by_ice looks up a business by its 15-digit ICE (Identifiant Commun de l'Entreprise) number, which is Morocco's national business tax identifier.
Listing Detail and Reviews
get_listing_detail accepts a full listing URL from any search result and returns a richer set of fields: rc (RC registration number), ice, email, address, website, director, and geographic coordinates (latitude, longitude). get_listing_reviews takes the same URL format and returns an array of review objects — each with author, content, rating, and date — plus total_reviews and average_rating (null when no reviews exist).
Browsing by Category and Discovery
browse_category accepts a category_slug such as restaurants, climatisation, or cliniques and pages through all businesses in that category nationwide. get_top_activities returns the full list of activity categories available on the platform, each with a name and url. get_top_brands does the same for brands. These two discovery endpoints require no inputs and serve as entry points for building category-level or brand-level scrapers.
- Build a leads database of Moroccan businesses filtered by city and activity using
search_by_city - Verify a company's legal identity by cross-referencing ICE numbers via
search_by_ice - Reverse-lookup an unknown Moroccan phone number to identify the associated business with
search_by_phone - Aggregate review scores and sentiment for local service providers using
get_listing_reviews - Enrich a CRM with director names, emails, and geolocation by calling
get_listing_detailon matched listings - Map all businesses in a specific category across Morocco using
browse_categorywith pagination - Identify which brands have the most retail representation by iterating
search_by_brandacrossget_top_brandsoutput
| 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 telecontact.ma have an official developer API?+
What fields does `get_listing_detail` return beyond what search results include?+
get_listing_detail returns fields not available in search results: rc (RC registration number), ice (ICE tax number), email, website, director (manager name), and geographic coordinates (latitude, longitude). Search result objects only include name, url, city, and summary.Does the API return opening hours or social media links for listings?+
get_listing_detail covers contact info, legal identifiers, address, and geolocation. You can fork this API on Parse and revise it to add an endpoint that captures opening hours or social media profile links if the listing page exposes them.How does pagination work across search and browse endpoints?+
search_national, search_by_city, browse_category) return 20 results per page. The total field in each response gives the full result count, so you can calculate the number of pages needed by dividing total by 20 and iterating the page parameter.Is coverage limited to Morocco, and can I filter by region rather than specific city?+
search_by_city endpoint requires a named city (e.g., rabat, casablanca) rather than a region or province. Region-level filtering is not currently supported. You can fork this API on Parse and revise it to add a region-based browse endpoint if the source exposes that grouping.