Moteur.ma API & Scraper
Moteur.ma is Morocco's car site, with two sides, and this API reads both.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
On the used side, `search` filters about 123,000 live ads by make, model, city, fuel, gearbox, body type, colour, price, year and mileage, 30 ads a page, and `listing` returns one ad in full: price in dirhams, year, mileage, fuel, gearbox, doors, fiscal power, the seller's description, history flags such as first owner and accident history, equipment, every photo, the view count, the contact phone and WhatsApp link, and whether the seller is a private person or a dealer. On the new side, `new_models`, `new_versions` and `new_version` give the official Moroccan price list: 74 makes, 402 models and 1,254 versions on 2026-10-07, each version with its showroom price, any running promotion, registration and other fees, the on-the-road price and the full technical sheet. `makes` and `new_catalog` list the slugs and ids the other calls take.
What a Moteur.ma field actually contains
Fields that read differently from how they look. Every row was measured against live Moteur.ma pages on 2026-10-07.
| Field | What it holds |
|---|---|
| price_mad vs price_label | price_label is the price exactly as the ad prints it ('89,000 MAD'). price_mad is the number, or null when the ad says 'Appeler pour le prix' (call for price). 257 of 359 search rows carried a price in both of our runs. |
| showroom_price_mad | The dealer's list price for a new version, before any promotion. For the Citroën C3 Aircross 1.2 PureTech 110 MAX BVM it was 224,900 MAD. |
| discount_mad and promo_price_mad | The running promotion and the price after it: 32,000 off, 192,900 MAD for that same C3 Aircross. promo_valid_until is the end date the page prints (2026-10-31). Both are null when no promotion runs. |
| on_the_road_price_mad | The 'prix clé en main': the price after promotion plus registration_fee_mad and other_fees_mad. For the C3 Aircross: 192,900 + 4,555 + 2,700 = 200,155 MAD. When no fees are listed it equals the showroom price. |
| price_ld_json and price_mismatch | A second reading of the same version's price from the page's own structured data. It matched our computed price on 7 of 7 versions in each run; price_mismatch turns true if they ever disagree. |
| seller.type | 'private' when the ad is published by a private person, 'professional' for a dealer, whose name and logo are then returned (for example BMW PREMIUM SELECTION, member since Feb 2017). |
| phone and whatsapp_url | The contact number the ad page wires to its Call and WhatsApp buttons. 8 of 8 sampled ads carried one in each run. |
| body_type and color on a used ad | Only what the seller filled in. The page prints N/A otherwise, which we return as null; 2 of 8 sampled ads had them. |
Used-car search has no free-text box and no sort order on Moteur.ma itself: ads come newest first as the site lists them, and you narrow with the filters.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/moteur-ma/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"brand": "dacia",
"model": "logan",
"fuel": "Diesel"
}
}{
"ok": true,
"meta": {
"api": "moteur-ma",
"endpoint": "search",
"mode": "live",
"latency_ms": 1232.6,
"record_count": 30,
"bytes": 916316,
"cache_hit": false,
"upstream_requests": 1,
"charged_credits": 3,
"version": "1.0.0",
"request_id": "1efdba2264c64103",
"queue_ms": 2.2,
"fetched_at": "2026-10-07T15:52:09.960Z"
},
"data": {
"total": 2869,
"page": 1,
"page_size": 30,
"last_page": 96,
"has_more": true,
"filters_applied": {
"marque": "dacia",
"modele": "logan",
"carburant": "Diesel"
},
"listings": [
{
"id": "691541",
"url": "https://www.moteur.ma/fr/voiture/achat-voiture-occasion/detail-annonce/691541/dacia-logan.html",
"title": "location de voiture",
"price_mad": 250,
"price_label": "250 MAD",
"currency": "MAD",
"city": "Fes",
"published_at": "2026-10-07 15:30:39",
"year": 2026,
"gearbox": "Manuelle",
"fuel": "Diesel",
"mileage_km": 20000,
"description_snippet": "🚗 كراء السيارات ففاس ابتداءً من 250 درهم فقط! ✅ سيارات جديدة ونقية ✅ أثمنة واضحة بلا مفاجآت ✅ ت...",
"image": "https://content.avito.ma/classifieds/images/10156366539?t=moteur_feed"
},
{
"id": "669815",
"url": "https://www.moteur.ma/fr/voiture/achat-voiture-occasion/detail-annonce/669815/dacia-logan.html",
"title": "Dacia Logan 2025",
"price_mad": null,
"price_label": "Appeler pour le prix",
"currency": "MAD",
"city": "Sale",
"published_at": "2026-10-07 14:45:54",
"year": 2025,
"gearbox": "Manuelle",
"fuel": "Diesel",
"mileage_km": 32000,
"description_snippet": "BIENVENUE CHEZ AUTO AZRAAK ✅Dacia Logan ✅Modèle 2025 ✅Kilometrage 32.000km ✅Motorisation 1....",
"image": "https://www.moteur.ma/storage/media/images/ads/resized/10155513265-110538.jpg"
},
{
"id": "691473",
"url": "https://www.moteur.ma/fr/voiture/achat-voiture-occasion/detail-annonce/691473/dacia-logan.html",
"title": "logan 2023",
"price_mad": 125000,
"price_label": "125,000 MAD",
"currency": "MAD",
"city": "Beni Mellal",
"published_at": "2026-10-07 14:41:34",
"year": 2023,
"gearbox": "Manuelle",
"fuel": "Diesel",
"mileage_km": 156000,
"description_snippet": "sans adblue",
"image": null
}
]
}
}What the Moteur.ma API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search used cars for sale in Morocco on Moteur.ma (≈123,000 live ads): make, model, city, fuel, gearbox, body type, colour, price, year and mileage filters, 30 ads per page, newest first as the site orders them. Nothing is required: no parameters browses the whole used-car catalogue. | Price-intelligence teams call search to search used cars for sale in Morocco on Moteur.ma (≈123,000 live ads). | brand, model, city, fuel, gearbox, ... |
| listing | One used-car ad in full: price, make, model, year, mileage, fuel, gearbox, body, colour, doors, fiscal power, the seller's description, history flags (first owner, accident history, imported new, customs), equipment options, every photo, view count, the contact phone / WhatsApp link and the seller block (private or dealer name, logo, member since, city). Either `id` or `url`. | Classifieds aggregators call listing to get one used-car ad in full. | id, url, include_pii |
| makes | Every make and model slug the used-car `search` accepts, straight from the site's own filter data. | Resale and arbitrage tools call makes to get every make and model slug the used-car `search` accepts, straight from the site's own filter…. | brand |
| new_catalog | The new-car catalogue tree sold in Morocco: every make, its current models and every version id (feed them to `new_version`). | Lead-generation teams call new_catalog to get the new-car catalogue tree sold in Morocco. | brand |
| new_models | A make's current new-car range in Morocco with the official "from" price (MAD) and number of versions of each model. | Price-intelligence teams call new_models to get a make's current new-car range in Morocco with the official "from" price (MAD) and number of…. | brand |
| new_versions | Every version of one new model with its fuel, gearbox, fiscal power, horsepower and price — current price, list price and the promotion discount when one runs. | Classifieds aggregators call new_versions to get every version of one new model with its fuel, gearbox, fiscal power, horsepower and price. | brand, model |
| new_version | One new-car version in full: showroom price, promotion discount and promo price, registration and other fees, on-the-road price, promo end date, and the whole technical sheet — power, torque, 0-100, top speed, consumption, dimensions, boot, weight, battery and range — plus every equipment line. Either `id` or `url`. | Resale and arbitrage tools call new_version to get one new-car version in full. | id, url |
Call search from your stack
curl -X POST https://api.reefapi.com/moteur-ma/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"brand":"dacia","model":"logan","fuel":"Diesel"}'import requests
r = requests.post(
"https://api.reefapi.com/moteur-ma/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"brand": "dacia",
"model": "logan",
"fuel": "Diesel"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/moteur-ma/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"brand": "dacia",
"model": "logan",
"fuel": "Diesel"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.moteur-ma.search with {"brand":"dacia","model":"logan","fuel":"Diesel"}.Who uses this API and why
- Price a used car in Morocco: filter one make, model and year range and read the MAD prices and mileage of every comparable ad.
- Track dealer promotions: read new_versions for the models you follow and alert when discount_mad appears or changes.
- Compare the on-the-road cost of new cars across makes, fees included, from one price table per version.
- Build a lead list of Moroccan car dealers from the seller block of their ads, with phone and city.
- Measure the electric and hybrid used market by city with the fuel and city filters, page by page.
Questions developers ask before integrating
Do I need a Moteur.ma account or a Moroccan IP?
No. Every endpoint reads public pages without an account, and you call reefapi.com from anywhere.
How many used-car ads can I reach?
All of them. The site listed 123,076 used-car ads during our runs on 2026-10-07 and every page up to the last one is reachable: page 4,102 of the unfiltered list returned its 29 ads. Asking past the last page returns an empty list with the true total and a warning.
Which filters work, and how much do they narrow?
Measured in one run against 123,076 ads: Dacia 8,958, Dacia Logan 3,472, diesel 99,902, electric 416, automatic 50,633, Rabat 9,136, 100,000-150,000 MAD 26,437, model years 2018-2019 16,207, at most 50,000 km 31,334, black 10,608, SUV et 4x4 7,125.
What happens if I send a filter value Moteur.ma does not know?
We reject it with INVALID_PARAM and list the accepted values. Moteur.ma itself ignores an unknown fuel or colour and returns the whole catalogue, which would look like a working filter. An unknown make or model slug returns 0 results; the makes call lists every slug.
Can I get official new-car prices in Morocco?
Yes. new_models gives a make's range with the 'from' price, new_versions every version with its price, list price and discount, and new_version the full price table: showroom, promotion, registration and other fees, and on-the-road price, plus power, consumption, dimensions and equipment.
Why is price_mad null on some used ads?
Because the seller wrote 'Appeler pour le prix' instead of a price. We keep that text in price_label so you can tell 'no price' from a real price. A price ceiling filter on Moteur.ma also keeps these ads.
Do you return the seller's phone and name?
Yes, as the ad page publishes them: the contact phone, the WhatsApp link, the seller's name (or 'particulier' for a private seller), dealer logo, member-since date and city.
Can I search motorcycles or trucks?
Not yet. This API covers used cars and the new-car catalogue. Moteur.ma also has motorcycle, truck and rental sections that we have not opened.
What is the Moteur.ma API?
Moteur.ma API is a ReefAPI endpoint group for morocco's used-car ads and official new-car prices in mad: search, full ads with the seller's phone, and every version's price sheet. It returns live JSON through POST requests under /moteur-ma/v1.
Is the Moteur.ma API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Moteur.ma calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Moteur.ma login or account?
No login to Moteur.ma is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Moteur.ma data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Moteur.ma API use?
Moteur.ma actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Moteur.ma from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call moteur-ma actions with the same key, credit pool and JSON envelope used by normal REST requests.