DOANH NGHIỆP

API đối tác BIGMAP

Đưa dữ liệu doanh nghiệp, đặc sản, địa danh và tiện ích theo xã/phường mới của BIGMAP vào app hoặc website của bạn. Chỉ đọc, dữ liệu công khai. Muốn hiển thị nhanh không cần lập trình: dùng mã nhúng tại bigmap.vn/ma-nhung.

Cách dùng

  1. Gửi đăng ký ở cuối trang. BIGMAP duyệt và gửi API key qua email.
  2. Gửi key ở header X-Api-Key. Gọi từ trình duyệt thì có thể dùng ?key= — key khi đó chỉ chạy trên tên miền đã đăng ký.
  3. Địa chỉ gốc: https://api.bandoso.org/api/v1/open
curl -H "X-Api-Key: bm_live_…" "https://api.bandoso.org/api/v1/open/businesses?province=khanh-hoa&category=nha-hang&lat=12.2388&lng=109.1967"

Các điểm truy cập

GET /businessesDanh sách cơ sở. Tham số: province (slug tỉnh), ward (mã xã), category (slug ngành), q (từ khóa), lat & lng (xếp gần trước), page. 24 cơ sở / trang.
GET /businesses/{slug}Chi tiết cơ sở: giờ mở cửa, đang mở hay không, ảnh, sản phẩm & giá, link chat / chỉ đường.
GET /specialtiesĐặc sản. Tham số: province, q, page, per_page (≤ 48).
GET /specialties/{slug}Chi tiết đặc sản + nơi bán đã duyệt.
GET /placesĐịa danh. Tham số: province, kind, q, page, per_page.
GET /places/{slug}Chi tiết địa danh + cơ sở gần đó.
GET /utilitiesCác loại tiện ích công cộng (ATM, cây xăng, chợ, trạm y tế…).
GET /utilities/nearbyTiện ích quanh một điểm. Tham số: kind (slug), lat, lng, limit (≤ 50).
GET /categoriesDanh mục ngành (type=business|specialty…).
GET /provincesTỉnh / thành phố (34 đơn vị mới).
GET /provinces/{slug}/wardsXã / phường của tỉnh.

Ví dụ kết quả

{
  "data": [{
    "id": 123, "slug": "bun-ca-nam-beo", "name": "Bún cá Năm Beo", "type": "business",
    "category": { "name": "Quán bún, phở, mì", "slug": "quan-bun-pho" },
    "address": "2 Nguyễn Thiện Thuật", "ward": "Phường Nha Trang", "province": "Khánh Hòa",
    "lat": 12.2401, "lng": 109.1953, "rating": { "avg": 4.8, "count": 120 }, "verified": true,
    "cover_url": "https://bigmap.vn/storage/…",
    "url": "https://bigmap.vn/doanh-nghiep/bun-ca-nam-beo?utm_source=partner&utm_medium=api&utm_campaign=…",
    "directions_url": "https://bigmap.vn/ban-do?den=bun-ca-nam-beo&utm_source=partner…",
    "embed_url": "https://bigmap.vn/nhung/doanh-nghiep/bun-ca-nam-beo"
  }],
  "page": 1, "last_page": 4, "total": 87
}

Hạn mức & quy định

  • Mặc định 2.000 lượt gọi / ngày, tối đa 120 lượt / phút. Header X-RateLimit-Remaining cho biết số lượt còn lại. Cần nhiều hơn: liên hệ BIGMAP.
  • Ghi nguồn "© BIGMAP" và dùng link url / directions_url có sẵn khi hiển thị cơ sở — khách bấm sẽ mở BIGMAP để chỉ đường, nhắn tin, đặt lịch.
  • API không trả số điện thoại hay liên hệ riêng của cơ sở; khách liên hệ qua BIGMAP.
  • Không bán lại dữ liệu, không lưu trữ quá 24 giờ, không dùng để gửi tin nhắn quảng cáo.
  • Lỗi: 401 key sai / bị khóa · 403 tên miền chưa đăng ký · 429 hết hạn mức · 404 không tìm thấy.

Đăng ký API key