Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Avito.ma API page →
Classifieds & Second-hand

Avito.ma API & Scraper

Avito.ma API returns live Avito.ma data as clean JSON for avito.ma The primary endpoint, search, returns listings records including ad id, list id, title, description and price.

4 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 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.

Developers reach for it when they need to read second-hand listings, asking prices, seller inventory and country-specific listing ids without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Avito.ma scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, detail, categories, locations. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/avito-ma/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "q": "iphone",
    "category": 5010
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "avito-ma",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1653.4,
    "record_count": 37,
    "bytes": 866612,
    "cache_hit": false,
    "stop_reason": "limit_reached",
    "country": "MA",
    "site": "avito.ma",
    "total": 15546,
    "page": 1,
    "has_more": true,
    "next_page": 2,
    "promoted_count": 6,
    "project_count": 0,
    "filters_applied": [
      "q",
      "category"
    ],
    "resolved": {
      "city": null,
      "area": null,
      "category_id": "5010",
      "keyword": "iphone",
      "ad_type": "sell"
    },
    "charged_credits": 1,
    "version": "1.1.1",
    "request_id": "b7a6e2e87c294eaf",
    "queue_ms": 1.5,
    "fetched_at": "2026-11-03T17:32:00.396Z"
  },
  "data": {
    "listings": [
      {
        "ad_id": "78513323",
        "list_id": "58964964",
        "url": "https://www.avito.ma/fr/derb_ghallef/smartphone_et_téléphone/Apple_iPhone_Duo_256Go_58964964.htm",
        "title": "Apple iPhone Duo 256Go",
        "description": "Apple iPhone Duo 256Go\n\n..............................................\n\nAdresse : derb Ghalef, souk Ennajd - Casablanca\n\n..............................................\n\nLivraison à Casablanca le jour même\n\n..............................................\n\nLivraison partout au Maroc en 24h à 48h",
        "price": 32000,
        "price_display": "32000 DH",
        "currency": "DH",
        "price_matches_display": true,
        "old_price": null,
        "old_price_display": null,
        "monthly_payment": null,
        "ad_type": "SELL",
        "ad_type_label": "à vendre",
        "category_id": "5010",
        "category_name": "Smartphone et Téléphone",
        "category_path": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          }
        ],
        "city_id": "5",
        "city": "Casablanca",
        "area_id": "219",
        "area": "Derb Ghallef",
        "address": null,
        "latitude": null,
        "longitude": null,
        "posted_at": "2026-11-03T15:41:40Z",
        "seller_type": "STORE",
        "seller": {
          "seller_id": "5045",
          "name": "Citystore.ma",
          "is_verified": false,
          "is_ecommerce": null,
          "registered_since": null,
          "active_listings_count": null,
          "logo": "https://content.avito.ma/stores/2e/2e59d4d2-490b-41e6-9922-f6d222a88a76.jpg",
          "phone_verified": false,
          "phone_contact_type": null,
          "address": null,
          "website": null
        },
        "phone": "[redacted-phone]",
        "image": "https://content.avito.ma/classifieds/images/10157521501?t=images",
        "images": [
          "https://content.avito.ma/classifieds/images/10157521501?t=images",
          "https://content.avito.ma/classifieds/images/10157521502?t=images",
          "https://content.avito.ma/classifieds/images/10157521503?t=images"
        ],
        "image_count": 5,
        "is_premium": true,
        "is_highlighted": false,
        "is_urgent": false,
        "is_hot_deal": false,
        "is_promoted": true,
        "offers_shipping": false,
        "attributes": [
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]",
            "display": "[trimmed-depth]",
            "unit": "[trimmed-depth]",
            "section": "[trimmed-depth]",
            "code": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]",
            "display": "[trimmed-depth]",
            "unit": "[trimmed-depth]",
            "section": "[trimmed-depth]",
            "code": "[trimmed-depth]"
          }
        ]
      },
      {
        "ad_id": "78539293",
        "list_id": "58988934",
        "url": "https://www.avito.ma/fr/casablanca/smartphone_et_téléphone/Casablanca___Oulfa_58988934.htm",
        "title": "Casablanca - Oulfa",
        "description": "Je mets en vente un téléphone Apple iPhone duo de 256 Go, en état neuf. - Marque : Apple - Modèle : iPhone duo - Capacité de stockage : 256 Go - État du téléphone : neuf - Localisation : Casablanca",
        "price": 29500,
        "price_display": "29500 DH",
        "currency": "DH",
        "price_matches_display": true,
        "old_price": null,
        "old_price_display": null,
        "monthly_payment": null,
        "ad_type": "SELL",
        "ad_type_label": "à vendre",
        "category_id": "5010",
        "category_name": "Smartphone et Téléphone",
        "category_path": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          }
        ],
        "city_id": "5",
        "city": "Casablanca",
        "area_id": null,
        "area": null,
        "address": null,
        "latitude": null,
        "longitude": null,
        "posted_at": "2026-11-02T21:26:57Z",
        "seller_type": "PRIVATE",
        "seller": {
          "seller_id": null,
          "name": "zeyadالدار",
          "is_verified": null,
          "is_ecommerce": null,
          "registered_since": null,
          "active_listings_count": null,
          "logo": null,
          "phone_verified": false,
          "phone_contact_type": null,
          "address": null,
          "website": null
        },
        "phone": "[redacted-phone]",
        "image": "https://content.avito.ma/classifieds/images/10157706815?t=images",
        "images": [
          "https://content.avito.ma/classifieds/images/10157706815?t=images",
          "https://content.avito.ma/classifieds/images/10157706816?t=images"
        ],
        "image_count": 2,
        "is_premium": true,
        "is_highlighted": false,
        "is_urgent": false,
        "is_hot_deal": false,
        "is_promoted": true,
        "offers_shipping": false,
        "attributes": [
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]",
            "display": "[trimmed-depth]",
            "unit": "[trimmed-depth]",
            "section": "[trimmed-depth]",
            "code": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]",
            "display": "[trimmed-depth]",
            "unit": "[trimmed-depth]",
            "section": "[trimmed-depth]",
            "code": "[trimmed-depth]"
          }
        ]
      },
      {
        "ad_id": "78136982",
        "list_id": "58611634",
        "url": "https://www.avito.ma/fr/marrakech/smartphone_et_téléphone/iPhone_16_Pro_Max__256_Go___94__Batterie_58611634.htm",
        "title": "iPhone 16 Pro Max (256 Go) (94) Batterie",
        "description": "Téléphone en très bon état, jamais ouvert et aucune pièce changée.",
        "price": 8500,
        "price_display": "8500 DH",
        "currency": "DH",
        "price_matches_display": true,
        "old_price": null,
        "old_price_display": null,
        "monthly_payment": null,
        "ad_type": "SELL",
        "ad_type_label": "à vendre",
        "category_id": "5010",
        "category_name": "Smartphone et Téléphone",
        "category_path": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          }
        ],
        "city_id": "8",
        "city": "Marrakech",
        "area_id": null,
        "area": null,
        "address": null,
        "latitude": null,
        "longitude": null,
        "posted_at": "2026-11-03T04:56:40Z",
        "seller_type": "PRIVATE",
        "seller": {
          "seller_id": null,
          "name": "Abderrahim",
          "is_verified": null,
          "is_ecommerce": null,
          "registered_since": null,
          "active_listings_count": null,
          "logo": null,
          "phone_verified": false,
          "phone_contact_type": null,
          "address": null,
          "website": null
        },
        "phone": "[redacted-phone]",
        "image": "https://content.avito.ma/classifieds/images/10154818290?t=images",
        "images": [
          "https://content.avito.ma/classifieds/images/10154818290?t=images",
          "https://content.avito.ma/classifieds/images/10154818288?t=images",
          "https://content.avito.ma/classifieds/images/10154818285?t=images"
        ],
        "image_count": 6,
        "is_premium": true,
        "is_highlighted": false,
        "is_urgent": false,
        "is_hot_deal": false,
        "is_promoted": true,
        "offers_shipping": false,
        "attributes": [
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]",
            "display": "[trimmed-depth]",
            "unit": "[trimmed-depth]",
            "section": "[trimmed-depth]",
            "code": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]",
            "display": "[trimmed-depth]",
            "unit": "[trimmed-depth]",
            "section": "[trimmed-depth]",
            "code": "[trimmed-depth]"
          }
        ]
      }
    ],
    "projects": []
  }
}
Actions

What the Avito.ma API does

ActionDescriptionConcrete use caseKey params
searchSearch Avito.ma by keyword and/or category, narrowed by city, district, price range, seller type and Avito's own ad flags. Covers every vertical on the site — phones, cars, apartments, furniture, jobs, services — and returns Avito's own result page (about 35-38 rows) with the total, the price both as a number and as the string the card prints, the seller's profile and phone number as the card publishes them and that vertical's own attribute rows. Every filter is verified against Avito's own parse of the request, so a value Avito does not understand is reported instead of quietly returning the whole catalogue. `ad_type` picks the sale, rent, holiday-rent or flat-share tree of a category (1010 + rent = apartments to let) and every row is checked to be of that type. Avito's new-development project cards (no ad id, not bound by the district filter) come back separately in `projects[]`, never mixed into `listings[]`. Give at least one of `q` or `category`.Price-intelligence teams call search to search Avito.ma by keyword and/or category, narrowed by city, district, price range, seller t….q, category, city, area, ad_type, ...
detailOne Avito.ma ad in full, by its `list_id` or by its address: title, the whole body text, price with the currency the ad publishes, category path, city and district, posting time, the complete photo gallery, the seller profile with its store id and listing count, the phone number the page publishes, and the ad's own attribute rows — storage and condition for a phone, year, mileage, gearbox and fuel for a car, rooms, surface and floor for an apartment. A removed or expired ad answers NOT_FOUND (Avito redirects it to a search page with HTTP 200, which this engine detects).Classifieds aggregators call detail to get one Avito.ma ad in full, by its `list_id` or by its address.list_id, url, lang
categoriesThe live Avito.ma category tree — an all-categories root plus the four sections (Avito Market, Immobilier, Véhicules, Entreprise) with every branch and leaf below them — 153 nodes, 140 distinct ids on 2026-11-03 (property leaves such as 1010 appear once in each of the sale, rent, flat-share and holiday-rent trees) — each with its id, its French name, its ad type (sell, let, vac_rent, co_rent), the `ad_type` value `search` needs to reach that exact node, and the url slug Avito uses for it. Use it to get the `category` id that `search` takes.Resale and arbitrage tools call categories to get the live Avito.ma category tree.lang
locationsEvery city and town Avito.ma publishes — about 600 (595 on 2026-11-03) — with its id, the slug `search` takes, the live number of ads in it, and the districts inside it. This is the live filter block Avito builds its own city picker from, so the ad counts are current.Lead-generation teams call locations to get every city and town Avito.ma publishes.city, lang
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/avito-ma/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"q":"iphone","category":5010}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.avito-ma.search with {"q":"iphone","category":5010}.
Use cases

Who uses this API and why

  • Price-intelligence teams use Avito.ma to search Avito.ma by keyword and/or category, narrowed by city, district, price range, seller t….
  • Classifieds aggregators use Avito.ma to get one Avito.ma ad in full, by its `list_id` or by its address.
  • Resale and arbitrage tools use Avito.ma to get the live Avito.ma category tree.
  • Lead-generation teams use Avito.ma to get every city and town Avito.ma publishes.
FAQ

Questions developers ask before integrating

What is the Avito.ma API?

Avito.ma API is a ReefAPI endpoint group for avito.ma It returns live JSON through POST requests under /avito-ma/v1.

Is the Avito.ma API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Avito.ma calls use the same shared credit balance as every other ReefAPI engine.

Do I need an Avito.ma login or account?

No login to Avito.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 Avito.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 Avito.ma API use?

Avito.ma actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Avito.ma from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call avito-ma actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Avito.ma API an Avito.ma scraper?

It is the managed alternative to a DIY Avito.ma scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same avito.ma back as clean JSON.

Why does my Avito.ma scraper keep getting blocked?

Most Avito.ma scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.

Questions developers ask about Avito.ma data

From Stack Overflow, Reddit and search, answered with live calls on 2 Nov 2026.

Is there an official Avito.ma API for listings and prices?▾

Not a public one. Scraper vendors on Apify state that Avito.ma publishes no public data API, and an open-source Avito.ma MCP server on GitHub says it relies on private endpoints found by analysing the Android app, which Avito may change at any time.

ReefAPI's Avito.ma API returns the site's public listings as JSON: search covers every section (phones, cars, apartments, jobs) with city, district, price and seller-type filters, and detail returns one ad in full. categories and locations give the live category ids and city slugs.

curl · iPhone 15 in Casablanca, 3,000–8,000 DH
curl -X POST https://api.reefapi.com/avito-ma/v1/search \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"q":"iphone 15","category":5010,"city":"casablanca","price_min":3000,"price_max":8000}'

Real response, 2 Nov 2026: total 396 · page 1: 35 ads from 3,005 to 8,000 DH, median 6,700 · "iPhone 15 Pro Max 256G importé d'Europe non recyclé" 7,500 DH · 256 GB · Bon état · Aïn Chock · seller_type STORE

My Playwright scraper for Avito.ma works locally but gets a Cloudflare 403 ("Un instant…") on AWS Lambda. Why?▾

A developer on Stack Overflow describes exactly this: the same Playwright code loads Avito.ma on a laptop, but from AWS Lambda it gets HTTP 403 and Cloudflare's Turnstile page ("Vérification de sécurité en cours"), even with a French locale and the Africa/Casablanca timezone. The answer there points at the Lambda network and the browser's signals together, not at Playwright itself.

If the function only needs the data, call ReefAPI's Avito.ma API instead: it is one HTTPS POST, so there is no Chromium to ship in the Lambda, and detail takes the same avito.ma ad URL you were opening.

python · AWS Lambda handler
import json, os, urllib.request

def handler(event, context):
    req = urllib.request.Request(
        "https://api.reefapi.com/avito-ma/v1/detail",
        data=json.dumps({"url": event["url"]}).encode(),
        headers={"x-api-key": os.environ["REEF_KEY"], "content-type": "application/json"},
    )
    ad = json.load(urllib.request.urlopen(req, timeout=60))["data"]["listing"]
    return {"title": ad["title"], "price": ad["price"], "city": ad["city"],
            "attributes": {a["id"]: a["value"] for a in ad["attributes"]}}

Real response, 2 Nov 2026: "Skoda Octavia" · 209000 DH · Casablanca, Sidi Moumen · brand Skoda · model Octavia · regdate 2022 · mileage_exact 77800 · Manuelle · Diesel · 8 CV · 12 photos · verified store with 180 active ads

Why does Avito.ma ignore my keyword, city or district filter and return ads from all of Morocco?▾

The author of an open-source Avito.ma search tool on GitHub documents it: ?keyword= is silently ignored, a single-value ?cities= is dropped, ?areas= does nothing and there is no sort parameter at all, yet the page still loads with ads from the whole country.

ReefAPI's Avito.ma API takes city and area as Avito slugs or names, accents optional (Fès resolves to fes), lists what Avito actually applied in meta.filters_applied and meta.resolved, and answers INVALID_PARAM at no charge when Avito does not know a value. English names such as Fez, Marrakesh, Tangier or Casa resolve too; take the accepted slugs and every city's districts from locations.

curl · private sellers' used cars in Fès
curl -X POST https://api.reefapi.com/avito-ma/v1/search \
  -H "x-api-key: $REEF_KEY" -H "content-type: application/json" \
  -d '{"category":2010,"city":"Fès","seller_type":"private","ad_options":"has_price"}'

Real response, 2 Nov 2026: resolved.city "fes" · filters_applied city, category, seller_type, ad_options · total 5,789 · 38 of 38 rows in Fès

How do I get apartment prices per m² by neighbourhood in Casablanca, Rabat or Marrakech?▾

Moroccan real-estate projects on GitHub, such as AvitoTrackr ("prix moyen par m2 des appartements dans différentes villes"), scrape Avito.ma apartment ads and divide the price by the surface.

With ReefAPI, search category 1010 with city, area and ad_options: has_price; each row carries price in dirham and the surface as the size attribute. New-development project cards that Avito mixes into the page come back separately in projects, so listings holds only ads; take the median, because sellers sometimes post a monthly rental in the sale section.

python · median DH/m² for one district
import requests, statistics

ppm2 = []
for page in (1, 2):
    r = requests.post(
        "https://api.reefapi.com/avito-ma/v1/search",
        headers={"x-api-key": REEF_KEY},
        json={"category": 1010, "city": "casablanca", "area": "maarif",
              "ad_options": "has_price", "page": page},
    )
    for ad in r.json()["data"]["listings"]:
        size = next((a["value"] for a in ad["attributes"] if a["id"] == "size"), None)
        if ad["list_id"] and ad["price"] and size:
            ppm2.append(ad["price"] / size)
print(len(ppm2), round(statistics.median(ppm2)))

Real response, 2 Nov 2026: Maarif, Casablanca: 755 ads, median 14,545 DH/m² over 67 priced ads on pages 1–2 · Agdal, Rabat: 171 ads, 17,940 DH/m² (52) · Guéliz, Marrakech: 853 ads, 19,819 DH/m² (44)

How do I build a used-car price dataset from Avito.ma for a price-prediction model?▾

It is a common Moroccan ML project: one CarPrice AI repository on GitHub trained on 99,506 cars scraped from 500 Avito.ma pages, and when an r/Morocco poster shared an analysis of 1,815 Avito.ma used-car listings, the first question was how he scraped them; only 1,158 of his 1,815 had a usable asking price.

With ReefAPI, page through category 2010 (Voitures d'occasion) with ad_options: has_price: each row already carries the model year (regdate), mileage_exact, gearbox and fuel, and detail adds brand, model, fiscal horsepower and first-owner status. Mileage is whatever the seller typed, so clean it before training.

python · priced used cars, page by page
import requests

rows, seen = [], set()
for page in range(1, 6):
    r = requests.post(
        "https://api.reefapi.com/avito-ma/v1/search",
        headers={"x-api-key": REEF_KEY},
        json={"category": 2010, "ad_options": "has_price", "page": page},
    )
    data = r.json()
    for ad in data["data"]["listings"]:
        if ad["list_id"] in seen:
            continue
        seen.add(ad["list_id"])
        attrs = {a["id"]: a["value"] for a in ad["attributes"]}
        rows.append({"list_id": ad["list_id"], "title": ad["title"], "price": ad["price"],
                     "city": ad["city"], "year": attrs.get("regdate"),
                     "km": attrs.get("mileage_exact"), "gearbox": attrs.get("bv"),
                     "fuel": attrs.get("fuel")})
    if not data["meta"]["has_more"]:
        break

Real response, 2 Nov 2026: category 2010: 141,620 ads, 111,758 with a price · "Skoda Octavia" 209000 DH, regdate 2022, mileage_exact 77800, Manuelle, Diesel → detail: brand Skoda, model Octavia, 8 CV, first_owner Non · a 1995 Renault 19 lists 99 km

How do I get an alert when a new Avito.ma rental appears in Rabat under my budget?▾

Developers build this as a small bot: one open-source Avito.ma bot on GitHub polls new apartment ads, filters them by price and location and sends each match to Telegram once, keeping the ids it has already sent in SQLite, because "the best opportunities are often gone within minutes".

With ReefAPI, poll page 1 of search with category 1300 (Locations Immobilières; 1500 is holiday rentals by the night), city and price_max, and alert on any list_id you have not stored. Dedupe on list_id rather than on the date: rows come roughly newest first, and an older ad can come back near the top with a fresh posted_at.

python · run every few minutes
import requests

seen = set()  # load from your database
r = requests.post(
    "https://api.reefapi.com/avito-ma/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={"category": 1300, "city": "rabat", "price_max": 6000},
)
for ad in r.json()["data"]["listings"]:
    if ad["category_id"] == "1010" and ad["list_id"] not in seen:
        seen.add(ad["list_id"])
        print(ad["price"], ad["area"], ad["title"], ad["url"])  # send to Telegram here

Real response, 2 Nov 2026: Rabat, up to 6,000 DH a month: total 1,614 · newest "APPARTEMENT MEUBLÉ CENTRE-VILLE PRÈS BAB AL HAD" 5000 DH, 40 m², Hassan, posted_at 22:17 UTC · page 1: 27 apartments, 5 shops, 3 offices

docs / avito-ma

Avito.ma

Avito.ma

base /avito-ma/v14 endpoints
post/avito-ma/v1/detail1 credit

One Avito.ma ad in full, by its `list_id` or by its address: title, the whole body text, price with the currency the ad publishes, category path, city and district, posting time, the complete photo gallery, the seller profile with its store id and listing count, the phone number the page publishes, and the ad's own attribute rows — storage and condition for a phone, year, mileage, gearbox and fuel for a car, rooms, surface and floor for an apartment. A removed or expired ad answers NOT_FOUND (Avito redirects it to a search page with HTTP 200, which this engine detects).

ParameterAllowed / rangeDescription
list_idoptional—The ad's `list_id` from a search result — the number that ends an avito.ma ad address. Give this or `url`.
urloptional—Full avito.ma ad address, either the short /vi/<id>.htm form or the long friendly one. Use `list_id` when you already have the number.
lang = froptionalfr · arInterface language for the category and location names Avito prints. Ad titles and bodies are whatever the seller wrote, in French or Arabic, either way.
Try in playground →
post/avito-ma/v1/categories1 credit

The live Avito.ma category tree — an all-categories root plus the four sections (Avito Market, Immobilier, Véhicules, Entreprise) with every branch and leaf below them — 153 nodes, 140 distinct ids on 2026-11-03 (property leaves such as 1010 appear once in each of the sale, rent, flat-share and holiday-rent trees) — each with its id, its French name, its ad type (sell, let, vac_rent, co_rent), the `ad_type` value `search` needs to reach that exact node, and the url slug Avito uses for it. Use it to get the `category` id that `search` takes.

ParameterAllowed / rangeDescription
lang = froptionalfr · arInterface language for the category and location names Avito prints. Ad titles and bodies are whatever the seller wrote, in French or Arabic, either way.
Try in playground →
post/avito-ma/v1/locations1 credit

Every city and town Avito.ma publishes — about 600 (595 on 2026-11-03) — with its id, the slug `search` takes, the live number of ads in it, and the districts inside it. This is the live filter block Avito builds its own city picker from, so the ad counts are current.

ParameterAllowed / rangeDescription
cityoptional—Return only this city (by slug, name or id) and its districts. Omit for all of them.
lang = froptionalfr · arInterface language for the category and location names Avito prints. Ad titles and bodies are whatever the seller wrote, in French or Arabic, either way.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.