Partner API · v1 · P2

Partner API dokumentacija

REST API za velike partnere — agencije sa preko 100 oglasa, MLS-aggregatore i investitore. Auth preko API key-a, rate limit 100 req/min.

Bearer auth

API key se generiše u /dashboard/agency · Settings

100 req/min

Rate limit po API key. Burst do 200.

Privacy-by-design

PRO-polja samo verified realtors; bez tracking-a klijenata.

Base URL

https://api.pronek.rs/v1

Endpoints

GET/api/v1/listings

Lista oglasa sa filterima (paginacija).

Params: listing_type, city, price_min, price_max, area_min, area_max, property_type, limit, offset

Primer

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.pronek.rs/v1/listings?listing_type=sale&city=beograd&price_max=200000"

Response

{
  "count": 142,
  "next": "https://api.pronek.rs/v1/listings?offset=20",
  "results": [
    {
      "listing_id": "uuid",
      "external_id": "A-101",
      "listing_type": "sale",
      "property_type": "apartment",
      "city": "Beograd",
      "neighborhood": "Novi Beograd",
      "price_amount": 89000,
      "price_currency": "EUR",
      "area_m2": 52,
      "rooms_count": 2,
      "advertiser_type": "agency",
      "photos": [...]
    }
  ]
}
GET/api/v1/listings/:id

Detalji jednog oglasa.

Params: :id (UUID)

Primer

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.pronek.rs/v1/listings/9f1a-..."

Response

/* puni listing object, PRO-polja samo za verified realtors */
POST/api/v1/listings

Kreiranje oglasa (zahteva organization_id).

Params: Body: RS-MLS standard schema

Primer

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing_type":"sale","city":"Beograd","price_amount":89000,...}' \
  "https://api.pronek.rs/v1/listings"

Response

{ "listing_id": "uuid", "status": "pending_review", ... }
POST/api/v1/imports

Pokreni XML/CSV import (samo verified Org).

Params: feed_url, format (xml|csv|json), schedule (optional cron)

Primer

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"feed_url":"https://agency.rs/feed.xml","format":"xml"}' \
  "https://api.pronek.rs/v1/imports"

Response

{ "import_run_id": "uuid", "status": "processing" }
GET/api/v1/projects/:id/units

Lista jedinica projekta investitora.

Params: :id (UUID), status (available|reserved|sold)

Webhooks

Subscribe na događaje preko Settings · Webhooks u agency panelu.

EventPayload
listing.approved{ listing_id, organization_id, approved_at }
listing.rejected{ listing_id, reason, moderator_comment }
contact.event{ event_type, listing_id, ip_hash, timestamp }
import.completed{ import_run_id, total, created, updated, errors }
fixation.received{ fixation_id, agent_id, unit_id, client_phone_hash }

Treba vam Partner API?

Javite se: partneri@pronek.rs · API key u toku 1 dana posle verifikacije Organization.

Kontakt