Dokumentasi/API/API pencarian & discovery/GET /api/v1/discovery/programmatic-params

Pahami parameter discovery programatik.

Endpoint ini dipakai untuk membentuk kombinasi kategori dan kota yang layak dijadikan halaman discovery programatik di web.

Auth dan validasi

  • Autentikasi: tidak perlu.
  • Query opsional: limit.
  • Nilai default limit saat ini 500 dan batas maksimalnya 1000.
GET /api/v1/discovery/programmatic-params?limit=100

Cakupan data

  • Backend hanya mengambil provider yang sudah tayang dan punya kota.
  • Ambang discovery saat ini adalah trustLevel >= 1.
  • Kategori child akan dinaikkan ke kategori induk aktif bila parent-nya ada dan aktif.
  • path dibentuk dari gabungan categorySlug dan citySlug yang sudah disederhanakan.

Field respons yang penting

  • Setiap item di data[] mewakili satu kombinasi kategori dan kota yang lolos syarat discovery.
  • categorySlug memakai kategori induk jika kategori child punya parent aktif.
  • citySlug dibentuk dari nama kota yang sudah dinormalisasi ke slug URL.
  • meta.trustThreshold menunjukkan ambang minimal trust yang dipakai query saat ini.

Respons sukses

{
  "data": [
    {
      "categorySlug": "digital-infrastructure",
      "city": "Jakarta",
      "citySlug": "jakarta",
      "path": "/digital-infrastructure-terbaik-jakarta"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 500,
    "trustThreshold": 1
  }
}