Avito.ma Morocco Classifieds Search Scraper

What does the Avito.ma Morocco Classifieds Search Scraper do?

This Actor collects structured, publicly visible search results from Avito.ma, Morocco's classifieds marketplace. It is an Avito.ma API alternative for public search pages and supports keyword, category, and city filters without requiring private account data.

The Actor uses the public search page's embedded structured data when available and a small DOM fallback for listing links. If Avito.ma reports Cloudflare, CAPTCHA, login, paywall, geographic, rate-limit, device-verification, or access-denied protection, the Actor rotates a bounded session and then fails clearly. Failed runs never add synthetic diagnostic rows to the dataset.

Why use this Avito.ma scraper?

• Search vehicles, real estate, electronics, and other public categories.
• Keep a stable listing ID and absolute listing URL for downstream deduplication.
• Capture public price, currency, location, category, seller label, media URLs, attributes, and listing flags when exposed.
• Limit both result count and inspected search pages with bounded input controls.
• Run on Apify with scheduling, API access, monitoring, webhooks, and proxy configuration.

What data can the Actor extract?

Field	Type	Description
id	string	Public listing identifier.
title	string	Public listing title.
listingUrl	string	Absolute Avito.ma listing URL.
price, oldPrice, monthlyPayment	number	Public price values when provided.
currency	string	Price currency label or code.
location, city, district	string	Public location fields.
category, parentCategory	string	Public category labels.
imageUrls, videoUrls	array	Public media URLs.
sellerName, sellerType	string	Public seller attribution when shown.
params	object	Public secondary listing attributes.
isPremium, isUrgent, isHotDeal	boolean	Public listing flags.
searchQuery, scrapedAt	string	Request and collection provenance.

How to scrape Avito.ma search results

1. Open the Actor and select the Input tab.
2. Enter a query, a category such as voitures, and optionally a city such as casablanca.
3. Set maxItems. Use maxPages when you want a stricter page bound; 0 derives a bounded limit from maxItems.
4. Keep the residential Morocco proxy default for cloud runs, or explicitly disable the proxy for local connectivity checks.
5. Start the run and download the dataset in JSON, CSV, Excel, or another supported format.

Use the API tab for programmatic runs. Scheduling and webhooks are useful for recurring public-market monitoring, while proxy configuration can be supplied through the input tab when permitted for your account and use case.

How much does it cost to scrape Avito.ma?

Actor cost depends on Playwright compute time and the proxy configuration selected for the run. Smaller maxItems and maxPages values reduce browser time. Cloudflare or another access-control response fails the run after bounded retries, so plan for the source site's availability and any applicable Apify proxy charges.

Input

See the input tab for full configuration options:

• query: optional keyword search.
• category: category path; defaults to voitures in the Actor logic.
• city: optional lower-cased city path.
• maxItems: 1–200 listings, default 50.
• maxPages: 0–10 public search pages, default 0 for a bounded automatic limit.
• saveDebugHtml: deprecated compatibility flag; raw page HTML is not persisted.
• proxyConfiguration: Apify proxy settings, defaulting to residential Morocco routing.

Output

The dataset contains only verified listing records with an Avito.ma .htm URL, stable ID, title, page number, source search URL, and scrape timestamp. If public access is unavailable, the run fails and its dataset stays empty. The fixed OUTPUT key records counts and run status.

{
  "position": 1,
  "id": "123456789",
  "title": "Example family car in good condition",
  "listingUrl": "https://www.avito.ma/fr/maroc/voitures/example-listing_123456789.htm",
  "price": 125000,
  "currency": "MAD",
  "city": "Casablanca",
  "category": "Cars",
  "source": "avito.ma",
  "sourceSearchUrl": "https://www.avito.ma/fr/casablanca/voitures?query=toyota",
  "page": 1,
  "scrapedAt": "2026-01-15T12:00:00.000Z"
}

Tips, troubleshooting, and support

Use a reasonable limit and respect Avito.ma's terms, robots rules, and rate limits. A failed access-control run means the public page denied access; do not treat it as an empty successful search or attempt to bypass the protection. The Actor does not solve CAPTCHAs or use private sessions. For feedback, use the Issues tab and the API tab for integration questions.

FAQ and disclaimer

Does this Actor access private seller information?

No. It reads only fields exposed on public search pages. A public phone number may appear when Avito.ma exposes it; do not use or retain personal data without a legitimate lawful purpose.

Our Actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our Actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.