Publi24 API: anunțurile de pe publi24.ro în JSON

Pe Publi24 apar anunțuri gratuite din toată România: garsoniere de închiriat în Timișoara, apartamente de vânzare, mașini, biciclete, locuri de muncă. Prin API ai la dispoziție căutarea după cuvânt în anunțurile publice, cu prețul, localitatea, începutul descrierii și marcajul de anunț promovat, iar cu `listing_id` primit de acolo citești anunțul întreg: descrierea completă, fotografiile, caracteristicile (suprafață utilă, etaj, compartimentare, an de construcție) și prețul în moneda în care l-a pus autorul. Dacă publici sau promovezi anunțuri pe Publi24, API-ul nu te ajută cu asta: nu adaugă anunțuri, nu le reactualizează și nu se conectează la contul tău. Lucrează doar cu paginile publice ale site-ului, din partea celui care caută.

Exemplu funcțional

Pentru „garsoniera timisoara” site-ul raportează 1 003 anunțuri; pe prima pagină 8 din 24 erau promovate, iar printre chirii a apărut și o garsonieră de vânzare (o recunoști după `de-vanzare` din `listing_id`). La 20 din 24 de rânduri `price_disagreement` era `true`: căutarea afișează suma în lei, iar datele sursei au altă sumă: garsoniera din zona Gării apare cu 1 390 RON, `source_price` are 260, iar `detail` pe același anunț dă 260 EUR. Pentru o medie a chiriilor, ia prețul din `detail` sau ține cont de semnal; nu trata `source_price` din căutare ca sumă în lei.

curl -X POST https://api.reefapi.com/publi24/v1/search \
  -H "x-api-key: CHEIA_TA" \
  -H "content-type: application/json" \
  -d '{"query": "garsoniera timisoara"}'

{
  "ok": true,
  "data": {
    "query": "garsoniera timisoara",
    "listings": [
      {
        "listing_id": "/anunturi/imobiliare/de-inchiriat/apartamente/garsoniera/anunt/de-inchiriat-garsoniera-in-zona-lipovei/1573d23f613f7847175d773955d8dd79.html",
        "title": "De inchiriat garsoniera in zona Lipovei",
        "price": { "amount": 1284.0, "currency": "RON", "display": "1 284 RON" },
        "source_price": { "amount": null, "currency": null },
        "price_disagreement": false,
        "location": "Lipovei, Timisoara, Timis",
        "promoted": true
      },
      ...
      {
        "listing_id": "/anunturi/imobiliare/de-inchiriat/apartamente/garsoniera/anunt/garsoniera-de-inchiriat-in-zona-garii/d2gf7e9fg3h27g25d3degd6fd15e42hg.html",
        "source_id": "d2gf7e9fg3h27g25d3degd6fd15e42hg",
        "url": "https://www.publi24.ro/anunturi/imobiliare/de-inchiriat/apartamente/garsoniera/anunt/garsoniera-de-inchiriat-in-zona-garii/d2gf7e9fg3h27g25d3degd6fd15e42hg.html",
        "title": "Garsonieră de închiriat în zona Gării",
        "price": { "amount": 1390.0, "currency": "RON", "display": "1 390 RON" },
        "source_price": { "amount": 260.0, "currency": "RON" },
        "price_disagreement": true,
        "location": "Garii, Timisoara, Timis",
        "description_excerpt": "Inchiriez apartament o camera , renovat , dotat cu tot ce trebuie , aproape de Gara de Nord , ...",
        "promoted": false
      },
      ...
      {
        "listing_id": "/anunturi/imobiliare/de-vanzare/apartamente/garsoniera/anunt/garsoniera-de-vanzare-in-zona-buziasului/461ie6fd1d2674g0d89136igi4190f0e.html",
        "title": "Garsonieră de vânzare în zona Buziașului",
        "price": { "amount": 294068.0, "currency": "RON", "display": "294 068 RON" },
        "source_price": { "amount": 55000.0, "currency": "RON" },
        "price_disagreement": true,
        "location": "Buziasului, Timisoara, Timis",
        "promoted": false
      },
      ...
    ],
    "total": 1003,
    "page": 1,
    "last_page": 51,
    "has_more": true,
    "paging_limit": 2,
    "source_has_more": true
  },
  "meta": { "record_count": 24, "charged_credits": 3, "cache_hit": false, "mode": "live" }
}

Limite și note oneste

• Publi24 nu are nicio legătură cu acest API: nu e o interfață oficială, iar între noi și site nu există un parteneriat.
• O căutare se oprește la a doua pagină, deci la cel mult 48 de anunțuri, chiar dacă `total` e mult mai mare (1 003 la „garsoniera timisoara”, 7 324 la „bicicleta”). O cerere cu `page: 3` primește `INVALID_PARAM` și nu se taxează.
• Singurul parametru de căutare e textul: categoria, prețul, orașul și ordinea rezultatelor nu se pot alege. Cum site-ul caută și în descrieri, la „bicicleta” au venit și apartamente; 3 din cele 4 anunțuri promovate de pe prima pagină erau imobiliare.
• În căutare, prețurile anunțurilor puse în euro apar convertite în lei. Suma originală e în `source_price`, dar câmpul ei `currency` vine tot RON (garsoniera de mai sus: 260, cu RON). Moneda corectă o dă doar `detail` (260 EUR).
• Câmpul `location` din căutare e textul sursei și poate conține resturi de codificare sau text de interfață: „Take%25252bIonescu”, „Complexul%252bStudentesc” și „Vezi pe hartă” la aceeași căutare.
• Anunțurile de servicii sau „cumpăr” pot veni fără preț numeric (`price` null). GTIN nu am găsit în niciun anunț verificat. API-ul nu cere de la site numărul de telefon al vânzătorului, dar nici nu filtrează textul anunțului: la „bicicleta” un autor își scrisese numărul în litere chiar în descriere.
• Un apel `search` costă 3 credite, la fel și un apel `detail`.