API TenderHub

Data tender yang sama seperti di laman ini, dalam JSON, untuk sistem anda sendiri: 1,077 tender dan sebut harga yang masih boleh dibida, daripada 17 portal rasmi, disemak beberapa kali sehari. Baca sahaja; tiada data anda dihantar kepada kami selain permintaan itu sendiri.

Akses

API ialah perkhidmatan berbayar berasingan dengan kuota bulanan. Beritahu kami sistem yang ingin disambung dan anggaran permintaan sebulan.

Daftar akaun Log masuk

Pengesahan

Hantar kunci dalam header setiap permintaan. Kunci dalam URL ditolak, kerana URL tersimpan dalam log dan sejarah pelayar.

curl -H "Authorization: Bearer th_live_…" \
  "https://tenderhub.my/api/v1/tenders?state=Selangor&category=kerja"

Had

60 permintaan seminit bagi setiap kunci.
Kuota bulanan mengikut pakej, diset semula pada 1 haribulan (waktu Malaysia).
Setiap respons membawa X-Quota-Limit, X-Quota-Remaining dan X-Quota-Reset.
Maksimum 50 tender sehalaman.

`GET /tenders`

Cari tender. Tanpa parameter: semua yang masih boleh dibida, tarikh tutup paling hampir dahulu.

Parameter	Maksud
q	Kata kunci, cth. `pembersihan bangunan`. Perkataan biasa seperti "cleaning" turut mencari istilah notis.
state	Negeri, boleh beberapa dipisah koma: `Selangor,Kuala Lumpur`. Padan lokasi projek atau negeri agensi.
category	`kerja`, `bekalan`, `perkhidmatan`, `perunding`
type	`tender` atau `sebut_harga`
grade	Gred CIDB, cth. `G1,G2`
field_code	Kod bidang MOF; kod separa padan kumpulannya (`22` padan semua 22xxxx).
bumiputera_only	`1` untuk tender Bumiputera sahaja
status	`open` (lalai: masih boleh dibida), `closing_soon`, `closed`, `awarded`, `all`
closing_within	Tutup dalam N hari
new_since	Masa ISO 8601. Hanya tender yang pertama kali kami lihat selepas masa itu, tertua dahulu: cara menyegerak tanpa menarik semua data setiap kali.
sort	`closing`, `newest`, `relevance`
page, per_page	Halaman; `per_page` 1–50 (lalai 20)

Contoh satu item dalam data (tender sebenar):

{
    "id": "adefbb5b-75aa-493f-b09b-40245d65a8f9",
    "reference_no": null,
    "title": "PERKHIDMATAN PENYELENGGARAAN BERJADUAL LOJI RAWATAN KUMBAHAN MARKAS ANGKATAN KAPAL SELAM",
    "type": "sebut_harga",
    "category": "perkhidmatan",
    "status": "open",
    "agency": {
        "name": "TENTERA LAUT DIRAJA MALAYSIA (TLDM)",
        "state": null
    },
    "states": [
        "Sabah"
    ],
    "closing_at": "2026-11-18T00:00:00+08:00",
    "published_at": "2026-11-07T00:00:00+08:00",
    "first_seen_at": "2026-11-07T19:00:35+08:00",
    "document_price": null,
    "bumiputera_only": false,
    "qualifications": {
        "mof_field_codes": [
            "221010",
            "130301"
        ],
        "cidb_grades": [],
        "cidb_categories": [],
        "cidb_specializations": []
    },
    "source": {
        "code": "myprocurement",
        "name": "MyPROCUREMENT (Kementerian Kewangan)"
    },
    "source_url": "https://myprocurement.treasury.gov.my/advertisements/quotation/f1e91e890d23a4733ad3b2f047e84106",
    "url": "https://tenderhub.my/tender/perkhidmatan-penyelenggaraan-berjadual-loji-rawatan-kumbahan-markas-angkatan-kapal-selam-834422"
}

Respons juga membawa meta (page, per_page, total, last_page) dan links.next.

`GET /tenders/{id}`

Satu tender penuh: semua medan di atas, serta description, briefing, document_sale, site_visit_at, submission_location, documents (nama, berbayar atau tidak, pautan ke portal) dan changes (pindaan yang dikesan, cth. tarikh tutup dilanjutkan).

`GET /reference` · `GET /usage`

/reference memulangkan nilai yang diterima setiap penapis dan senarai sumber. /usage memulangkan kuota dan penggunaan bulan ini.

Ralat

{"error": {"code": "monthly_quota_exceeded", "message": "…"}}

401 invalid_key · 403 no_api_access · 404 not_found · 422 invalid_parameters · 429 rate_limited / monthly_quota_exceeded

Masa dan data

Semua masa dalam ISO 8601 dengan waktu Malaysia ditulis (+08:00).
source_url ialah notis asal di portal rasmi; semak di sana sebelum membida.
Dokumen berbayar dijual oleh agensi dan tidak disediakan melalui API; hanya pautannya.

Terma penggunaan

Data untuk kegunaan sistem dan pelanggan anda sendiri. Menjual semula atau mengedar semula data secara pukal, termasuk membina perkhidmatan tender yang bersaing, tidak dibenarkan.
Satu kunci untuk satu sistem; jangan kongsi kunci. Kunci yang disalah guna dibatalkan.
Lihat juga terma perkhidmatan.