API Import Produse

API-ul anuntz.ro permite publicarea, actualizarea și ștergerea anunțurilor programatic. Accesul se acordă la cerere.

Autentificare

Toate requesturile necesită header-ul X-API-Key cu cheia API primită de la echipa anuntz.ro.

X-API-Key: cheia_ta_api

URL de bază

https://api.anuntz.ro/api/v1/import

Rate Limiting

Maximum 100 de requesturi pe minut per cheie API.

Endpoints de referință

Județe

GET /judete

Returnează lista completă de județe cu ID-urile lor.

Localități dintr-un județ

GET /judete/{judet_id}/localitati

Returnează localitățile dintr-un județ specificat.

Categorii

GET /categories

Returnează toate categoriile și subcategoriile cu slug-urile lor.

Endpoints anunțuri

Listare anunțuri proprii

GET /listings?page=1&per_page=20&status=active

Creare anunț

POST /listings

{
  "title": "Canapea extensibilă 3 locuri",
  "description": "Canapea nouă, culoare gri...",
  "category_slug": "casa-si-gradina-mobila",
  "price": 1200,
  "currency": "RON",
  "is_negotiable": true,
  "judet_id": 40,
  "localitate_id": 3219,
  "image_urls": [
    "https://site-ul-meu.ro/poze/img1.jpg",
    "https://site-ul-meu.ro/poze/img2.jpg"
  ]
}

Câmpuri obligatorii: title, description, category_slug, price, judet_id, localitate_id

Câmpuri opționale: currency (RON/EUR, default RON), is_negotiable, image_urls (max 8 URL-uri; conturile VIP pot trimite până la 30)

Județul, localitatea, coordonatele GPS se completează automat din judet_id și localitate_id.

Actualizare anunț

PUT /listings/{id}

{
  "title": "Titlu actualizat",
  "price": 999,
  "judet_id": 12,
  "localitate_id": 450
}

Se pot actualiza: title, description, price, currency, is_negotiable, judet_id, localitate_id.

Ștergere anunț

DELETE /listings/{id}

Opțional: {"sold": true} pentru a marca ca vândut.

Adăugare imagini

POST /listings/{id}/images

{
  "image_urls": [
    "https://site-ul-meu.ro/poze/img3.jpg"
  ]
}

Import bulk (max 50 anunțuri)

POST /listings/bulk

{
  "listings": [
    {
      "title": "Produs 1",
      "description": "Descriere produs 1",
      "category_slug": "casa-si-gradina-mobila",
      "price": 100,
      "judet_id": 40,
      "localitate_id": 3219
    },
    {
      "title": "Produs 2",
      "description": "Descriere produs 2",
      "category_slug": "electronice-si-electrocasnice-telefoane",
      "price": 200,
      "judet_id": 40,
      "localitate_id": 3220
    }
  ]
}

Coduri de eroare

401 — API key lipsă sau invalid
422 — Validare eșuată (câmpuri lipsă sau invalide)
429 — Rate limit depășit (max 100/min)
404 — Anunț negăsit sau nu vă aparține

Exemplu cURL

curl -X POST https://api.anuntz.ro/api/v1/import/listings \
  -H "X-API-Key: cheia_ta" \
  -H "Content-Type: application/json" \
  -d '{"title":"Produs test","description":"Descriere","category_slug":"diverse","price":100,"judet_id":40,"localitate_id":3219}'

Solicită acces API

Pentru a primi o cheie API, contactați-ne la office@anuntz.ro.

API Documentație