Tài liệu API mở

Danh sách tin đăng đã duyệt, có lọc và phân trang.

• limit — số tin mỗi lần lấy (mặc định 20)
• offset — bỏ qua bao nhiêu tin (mặc định 0)
• province — tỉnh/thành phố
• property_type — loại hình bất động sản
• min_price, max_price — khoảng giá (VNĐ)
• q — từ khoá tìm kiếm

curl -H "x-api-key: bdsk_..." \
  "https://bdsaisales.com/api/public/v1/listings?limit=20&province=Hà%20Nội"

Chi tiết một tin đăng theo đường dẫn thân thiện (slug).

• slug — mã đường dẫn của tin, lấy từ danh sách tin

curl -H "x-api-key: bdsk_..." \
  "https://bdsaisales.com/api/public/v1/listings/can-ho-2pn-quan-7"

Gửi khách hàng quan tâm vào phần mềm.

• full_name (bắt buộc) — họ tên khách
• phone (bắt buộc) — số điện thoại
• email, note — thông tin thêm
• property_slug — tin đăng khách quan tâm
• channel, ref_code, utm_source, utm_medium, utm_campaign — nguồn khách

curl -X POST -H "x-api-key: bdsk_..." \
  -H "content-type: application/json" \
  -d '{"full_name":"Nguyễn Văn A","phone":"0901234567","property_slug":"can-ho-2pn-quan-7"}' \
  "https://bdsaisales.com/api/public/v1/leads"