API BODACC có miễn phí không?

Có, API BODACC miễn phí và mở trên dữ liệu công khai: thông báo, doanh nghiệp, cá nhân, danh bạ và thống kê, không cần khóa hay đăng ký. Gói Pro và Enterprise thêm khóa API và quyền truy cập ưu tiên.

Có cần khóa API không?

Không, truy cập công khai không yêu cầu khóa. Khóa API (tiền tố sk_bodacc_) được cung cấp với gói Pro và Enterprise cho các endpoint yêu cầu, từ Tài khoản của tôi rồi API.

Giới hạn của API là gì?

limit tối đa 500 kết quả mỗi yêu cầu và offset tối đa 10 000. Danh bạ giới hạn 200 trang mỗi trang 100. Nếu gặp 429, hãy tôn trọng tiêu đề Retry-After.

Dữ liệu có theo thời gian thực không?

Có, thông báo được hiển thị ngay khi đăng trên BODACC, trong khi tệp lịch sử tải xuống mỗi ngày một lần.

Bắt đầu nhanh với API BODACC : BODACC.io

Dữ liệu mở và miễn phí

API BODACC miễn phí và mở: cung cấp quyền truy cập dữ liệu mở và thời gian thực vào cơ sở dữ liệu đầy đủ của Công báo Chính thức — 11,3 triệu thông báo, 6,7 triệu doanh nghiệp, 1,9 triệu cá nhân (số liệu trực tiếp stats/counts). Trong khi tệp BODACC lịch sử được tải xuống một lần mỗi ngày, API công bố các thông báo ngay khi chúng được đăng tải, không cần khóa cho dữ liệu công khai.

# Số đếm chính xác, không cần khóa
curl "https://bodacc.io/api/bodacc/stats/counts"

Lệnh gọi đầu tiên

API công khai BODACC có thể truy cập không cần khóa cho dữ liệu. Endpoint được sử dụng nhiều nhất tìm kiếm thông báo theo từ khóa:

curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie&limit=5"

Phản hồi (trích đoạn):

{
  "total": 48231,
  "results": [
    {
      "id": "A2023001_000123",
      "dateparution": "2026-08-07",
      "typeavis": "A",
      "familleavis": "creation",
      "commercant": "BOULANGERIE DUPONT",
      "ville": "LYON",
      "numerodepartement": "69"
    }
  ],
  "limit": 5,
  "offset": 0
}

Đặc tả đầy đủ

API tài liệu hóa 46 endpoint (đã xác minh trên OpenAPI trực tiếp). Hai cách để khám phá chúng:

Swagger UI: https://bodacc.io/api/bodacc/docs
https://bodacc.io/api/bodacc/openapi.json

Các endpoint chính

Endpoint	Mô tả
`GET /api/bodacc/annonces`	Tìm kiếm thông báo (từ khóa, loại, thành phố, tỉnh, SIREN, ngày)
`GET /api/bodacc/annonces/{id}`	Chi tiết một thông báo + quan hệ (doanh nghiệp, cá nhân)
`GET /api/bodacc/entreprises`	Tìm kiếm doanh nghiệp (tên, SIREN, NAF, trạng thái, bộ lọc nâng cao)
`GET /api/bodacc/entreprises/{siren}`	Hồ sơ đầy đủ của một SIREN
`GET /api/bodacc/personnes/{id}`	Hồ sơ cá nhân (danh tính + nhiệm kỳ)
`GET /api/bodacc/annuaire/{role}`	Danh bạ thanh lý viên, đại diện, quản trị viên
`GET /api/bodacc/stats/counts`	Bộ đếm toàn cầu (thông báo, doanh nghiệp, cá nhân)

Xác thực

Truy cập công khai không yêu cầu bất kỳ khóa nào. Đối với các gói Pro và Enterprise, các endpoint được tài liệu hóa chấp nhận khóa API:

curl "https://bodacc.io/api/bodacc/annonces?q=boulangerie" \
  -H "X-API-Key: sk_bodacc_..."

Khóa cũng có thể được truyền qua Authorization: Bearer sk_bodacc_.... Khóa không hợp lệ hoặc bị thu hồi sẽ trả về 401.

Lỗi

API trả về các lỗi HTTP chuẩn với nội dung JSON chi tiết vấn đề:

400: tham số không hợp lệ
401: khóa API không hợp lệ hoặc bị thu hồi
404: không tìm thấy tài nguyên
429: quá nhiều yêu cầu — hãy tôn trọng tiêu đề Retry-After

Giới hạn

limit: từ 1 đến 500 mỗi yêu cầu
offset: tối đa 10 000 (phân trang chống trích xuất dữ liệu)
Dữ liệu được cập nhật theo thời gian thực sau mỗi lần công bố BODACC
Tìm kiếm theo loại sử dụng tổng chính xác được vật chất hóa (không có total_estime); các tìm kiếm văn bản kết hợp có thể trả về tổng ước tính ("total_estime": true)

Đi sâu hơn

Tìm kiếm thông báo: tất cả các tham số tìm kiếm
Hồ sơ doanh nghiệp: tìm kiếm và hồ sơ SIREN
Cá nhân và danh bạ: người quản lý và chuyên gia
Thống kê: bộ đếm và chuỗi dữ liệu
Xác thực và giới hạn: khóa API và các thực hành tốt

Bắt đầu nhanh với API BODACC