999.md API: anunțurile din Moldova în JSON

Pe 999.md lumea din Moldova vinde, cumpără și dă în chirie de toate: apartamente în Botanica sau Ciocana, mașini, telefoane, tehnică agricolă. Acest API face două lucruri: caută după text în anunțurile publice și citește un anunț întreg după numărul lui. Prețul rămâne așa cum l-a scris autorul, în lei moldovenești, euro sau dolari, fără nicio conversie, iar anunțul complet aduce și caracteristicile din formular: tipul ofertei, numărul de camere, suprafața, etajul, regiunea și localitatea. Nu are legătură cu contul de vânzător sau cu publicarea pe 999.md: nu postează, nu ridică anunțuri și nu citește mesaje, ci doar ce vede oricine deschide site-ul fără cont.

Exemplu funcțional

Căutarea a găsit 102 anunțuri; pe prima pagină de 20, patru aveau prețul în lei (MDL), restul în euro. În căutare, primele două rânduri arată la fel (900 MDL și 450 EUR, ambele preț fix), dar apartamentul de 900 de lei se închiriază pe zi: asta se vede doar în `listing_detail`, la „Tipul ofertei”: „De închiriat pe zi”. Dacă faci media chiriilor din Botanica numai din rândurile de căutare, iei la grămadă tarife pe zi și tarife lunare, în lei și în euro. Prima fotografie are în adresă un `?metadata=`: așa publică acum 999.md o parte din imagini, iar adresa e păstrată întocmai.

curl -X POST https://api.reefapi.com/999-md/v1/search \
  -H "x-api-key: CHEIA_TA_API" \
  -H "content-type: application/json" \
  -d '{"query": "chirie apartament botanica", "limit": 20}'

{
  "ok": true,
  "data": {
    "query": "chirie apartament botanica",
    "page": 1,
    "limit": 20,
    "count": 20,
    "results": [
      {
        "listing_id": "85621258",
        "url": "https://999.md/ro/85621258",
        "title": "Apartament cu 1 cameră, 27 m², 9 etaj",
        "price": 900,
        "currency": "MDL",
        "source_price": 900,
        "price_mode": "PM_FIXED",
        "price_unit": "UNIT_MDL",
        "bargain": false,
        "down_payment": 0,
        "is_expired": false,
        "images": [
          "https://i.simpalsmedia.com/999.md/BoardImages/900x900/9fdb831261f4fb4ac2f3bcc4469d4e1d.jpg?metadata=%7B%22metadata_version%22%3A+1%2C+%22width%22%3A+1200%2C+%22height%22%3A+900%2C+...%7D",
          ...
        ],
        "gtin": null
      },
      {
        "listing_id": "105452605",
        "url": "https://999.md/ro/105452605",
        "title": "Apartament cu 1 cameră, 37 m², 2 etaj",
        "price": 450,
        "currency": "EUR",
        "price_mode": "PM_FIXED",
        "price_unit": "UNIT_EUR",
        ...
      },
      ...
    ],
    "source_total": 102,
    "source_has_more": true,
    "has_more": true,
    "coverage": "Moldova native full-text search, Romanian presentation; pages 1-2."
  }
}

Limite și note oneste

• API-ul nu e făcut și nici aprobat de 999.md, iar între noi și administratorii site-ului nu există vreo înțelegere.
• Căutarea primește doar text: nu poți alege categoria, regiunea sau intervalul de preț și nici ordinea rezultatelor. Pagina 3 și cele de după sunt respinse (`INVALID_PARAM`, verificat pe 26 octombrie), deci o căutare dă cel mult 40 de anunțuri, chiar dacă `source_total` arată mai multe (102 în exemplul de mai sus, 22 042 la „apartament chisinau”).
• Rândurile din căutare nu au regiunea, localitatea și tipul ofertei; le găsești în `listing_detail`, printre `attributes`. Tot acolo afli că un anunț e de cumpărare: la „iphone 15”, primul rezultat era „Cumpăr iPhone-ul tău !”, cu „Tipul ofertei”: „Cumpăr”.
• Moneda e cea aleasă de autor (MDL, EUR sau USD) și nu convertim nimic. `price` e completat doar pentru prețuri fixe (`PM_FIXED`) într-o monedă recunoscută; altfel e `null`, iar câmpurile originale rămân în răspuns.
• Caracteristicile de tip da/nu sunt bifele din formularul anunțului și pot contrazice descrierea: la anunțul 105581090 descrierea spune „mobilat și utilat”, iar „Mobilat” vine `false`.
• Telefonul, e-mailul și adresa exactă nu sunt returnate ca atare. Descrierea vine însă exact cum a scris-o autorul, deci poate conține date de contact puse de el în text.
• Valoarea e cea pe care o cere autorul; la cât s-a vândut sau s-a închiriat până la urmă nu se vede nicăieri pe site. GTIN nu există în datele anunțurilor (`gtin` e mereu `null`), iar interfața în rusă a site-ului nu e acoperită.
• Fiecare apel costă 1 credit, fie căutare, fie anunț complet.