API Daftar Link

Jelajahi dan cari semua link pendek Anda.

Filter berdasarkan tanggal pembuatan, ID link, domain, grup, URL, dan lainnya untuk menemukan dengan cepat.

Cocok untuk dashboard admin, analitik, dan integrasi data.
Hanya tersedia pada paket premium ke atas.

GET

/api/link/v1/list?regStartYmdt={regStartYmdt}&regEndYmdt={regEndYmdt}&pages={pages} 


GET /api/link/v1/list
     ?regStartYmdt=2025-09-01+00%3A00%3A00
     &endYmd=2025-09-10+23%3A59%3A59
     &pages=1

Request Parameters

regStartYmdtdatetimerequired
Tanggal pembuatan tautan (Mulai). Menentukan tanggal mulai pencarian.
Contoh: 2025-09-01 00:00:00
regEndYmdtdatetimerequired
Tanggal pembuatan tautan (Selesai). Menentukan tanggal akhir pencarian.
Contoh: 2025-09-10 23:59:59
pagesintegerrequired
Nomor halaman. Nilai default adalah 1.
Setiap halaman mengembalikan 30 hasil. Misalnya, jika pages=2, hasil dikembalikan mulai dari entri ke-31.
linkIdstring
ID tautan.
domainstring
Domain tautan.
createTypeIdxinteger
Metode pembuatan tautan.
0: Semua tautan, 270: Dibuat dari dasbor, 272: Dibuat melalui API, 274: Dibuat melalui unggahan Excel.
grpIdxinteger
Grup tautan.
urlstring
URL Asli. Masukkan URL lengkap yang diawali dengan “https://”.
Pencarian dengan URL parsial tidak didukung.
ttlstring
Judul tautan. Mendukung pencarian parsial.
Jika terdapat spasi atau karakter Unicode, disarankan menggunakan URL Encoding.
brandLinkYnstring
Apakah ini tautan merek.
memostring
Catatan untuk pengelolaan tautan. Mendukung pencarian parsial.
Jika terdapat spasi atau karakter Unicode, disarankan menggunakan URL Encoding.
notfSubscYnstring
Apakah ini tautan berlangganan push.
qrBypassYn string
Default:N
Enum:
YN
Mengatur apakah akan melewati tautan pendek saat memindai kode QR dan langsung menuju ke URL asli yang ditentukan oleh pengguna.
Y: Langsung dialihkan ke URL asli tanpa melalui tautan pendek. (Statistik pemindaian QR tidak dicatat)
N: Melewati tautan pendek sebelum dialihkan ke URL asli. (Statistik pemindaian QR dicatat)
pushNotifyYnstring
Apakah notifikasi push untuk klik diaktifkan.
mailNotifyYnstring
Apakah notifikasi email untuk klik diaktifkan.
startDelYmdt datetime
Tanggal & waktu mulai penghapusan tautan.
endDelYmdt datetime
Tanggal & waktu selesai penghapusan tautan. 
{
    "code": 0,
    "message": "",
    "result": {
        "extra": {
            "pages": 1,
            "nextPages": 1,
            "nextYn": "N",
            "count": 2,
            "totalCount": 2
        },
        "list": [
            {
                "linkId": "createpostinglinks",
                "domain": "https://vvd.im",
                "typeIdx": 103,
                "typeNm": "URL",
                "redirectType": 302,
                "ttl": "Add YouTube videos using post links to create short links",
                "description": "",
                "metaImg": "",
                "memo": "",
                "url": "https://vvd.im/createpostinglinks",
                "grpIdx": 0,
                "grpNm": "",
                "acesCnt": 5072,
                "acesCntToday": 315,
                "acesMaxCnt": 0,
                "pernCnt": 4958,
                "lastClkYmdt": "2022-11-07 04:45:10",
                "longUrl": "https://vivoldi.com/blog/url-shortener/create-posts-link-url-shortener",
                "blockOverseasSticsYn": "N",
                "notfSubscYn": "N",
                "qrBypassYn": "N",
                "pushNotifyYn": "N",
                "mailNotifyYn": "N",
                "strtYmdt": "",
                "endYmdt": "",
                "expireUrl": "",
                "pwd": "",
                "nonmemberSticsPwd": "",
                "webhookEnableYn": "N",
                "webhookMetric": "C",
                "webhookFrequency": 1,
                "delYmdt": "",
                "regYmdt": "2022-11-02 04:27:05",
                "modYmdt": "2022-11-02 04:27:05"
            },
            {
                "linkId": "4Rth",
                "domain": "https://vvd.bz",
                "typeIdx": 103,
                "typeNm": "URL",
                "redirectType": 200,
                "description": "Discover diverse information and useful content on Naver's main page.",
                "metaImg": "https://s.pstatic.net/static/www/mobile/edit/2016/0705/mobile_212852414260.png",
                "ttl": "NAVER",
                "memo": "",
                "url": "https://vvd.bz/4Rth",
                "grpIdx": 128,
                "grpNm": "Test",
                "acesCnt": 19,
                "acesCntToday": 3,
                "acesMaxCnt": 1000,
                "pernCnt": 16,
                "lastClkYmdt": "2022-11-07 17:20:40",
                "longUrl": "https://www.naver.com",
                "blockOverseasSticsYn": "N",
                "notfSubscYn": "N",
                "qrBypassYn": "Y",
                "pushNotifyYn": "Y",
                "mailNotifyYn": "N",
                "strtYmdt": "2025-09-01 00:00:00",
                "endYmdt": "2025-09-30 23:59:59",
                "expireUrl": "https://yourdomain.com/event/closed.html",
                "pwd": "",
                "nonmemberSticsPwd": "123456",
                "webhookEnableYn": "Y",
                "webhookMetric": "C",
                "webhookFrequency": 1,
                "delYmdt": "2025-12-31 23:59:59",
                "regYmdt": "2022-11-07 17:10:22",
                "modYmdt": "2022-11-07 17:10:22"
            }
        ]
    }
}

Response Parameters

code integer
Kode respons: 0 = Berhasil, nilai lain = Error
message string
Pesan respons. Jika kode bukan 0, pesan error akan dikembalikan.
result object
extra object
Informasi halaman dan jumlah data.
pages integer
Nomor halaman saat ini
nextPages integer
Nomor halaman berikutnya
nextYn string
Apakah ada halaman berikutnya
count integer
Jumlah data pada halaman saat ini
totalCount integer
Jumlah total data
list array
Informasi Tautan
linkIdstring
ID tautan.
domainstring
Domain.
typeIdxinteger
Default:103
Enum:
103104106107108119447
Jenis tautan (IDX). 103: URL, 104: Postingan, 106: Deep Link, 107: Tombol, 108: Kartu, 119: QR, 447: Formulir.
typeNmstring
Jenis tautan (Nama).
redirectType integer
Default:302
Enum:
200301302
Jenis redirect.
Lihat halaman Terminologi untuk detailnya.
Fitur ini tersedia pada paket Personal ke atas.
ttlstring
Judul tautan.
description string
Jika redirectType adalah 200, meta tag description dapat ditetapkan.
metaImg string
Jika redirectType adalah 200, meta tag image dapat ditetapkan.
URL gambar harus diawali dengan https://.
memostring
Catatan untuk pengelolaan tautan.
urlstring
URL pendek.
grpIdxinteger
Grup tautan (IDX).
grpNmstring
Grup tautan (Nama).
acesCntinteger
Jumlah klik total.
acesCntTodayinteger
Klik hari ini.
acesMaxCnt integer
Jumlah klik maksimum yang diizinkan.
pernCnt integer
Jumlah pengguna unik (klik unik).
lastClkYmdtdatetime
Tanggal klik terakhir.
longUrlstring
URL asli.
notfSubscYnstring
Apakah ini tautan berlangganan push.
qrBypassYn string
Default:N
Enum:
YN
Mengatur apakah akan melewati tautan pendek saat memindai kode QR dan langsung menuju ke URL asli yang ditentukan oleh pengguna.
Y: Langsung dialihkan ke URL asli tanpa melalui tautan pendek. (Statistik pemindaian QR tidak dicatat)
N: Melewati tautan pendek sebelum dialihkan ke URL asli. (Statistik pemindaian QR dicatat)
pushNotifyYnstring
Apakah notifikasi push untuk klik diaktifkan.
mailNotifyYnstring
Apakah notifikasi email untuk klik diaktifkan.
strtYmdt datetime
Tanggal dan waktu mulai masa berlaku.
endYmdt datetime
Tanggal dan waktu berakhirnya masa berlaku.
expireUrl string
URL tujuan setelah masa berlaku berakhir.
pwd string
Kata sandi akses tautan.
Wajib dimasukkan saat mengakses tautan.
nonmemberSticsPwd string
Kata sandi statistik tautan.
Diperlukan untuk melihat data klik dan statistik. Bagikan hanya kepada pengguna yang berwenang.
webhookEnableYn string
Enum:
YN
Status aktivasi Webhook.
webhookMetric string
Enum:
CP
Kriteria penerimaan Webhook.
C: Berdasarkan jumlah klik, P: Berdasarkan pengguna unik.
webhookFrequency integer
Enum:
1501002003005001000
Frekuensi penerimaan Webhook.
1: Setiap klik, 50: Setiap 50 klik, 100: Setiap 100 klik, 300: Setiap 300 klik, 500: Setiap 500 klik, 1000: Setiap 1.000 klik.
delYmdtdatetime
Tanggal penghapusan tautan terjadwal.
regYmdtdatetime
Tanggal dibuat.
modYmdtdatetime
Tanggal diperbarui.

Kapan menggunakan API ini

Gunakan API ini dalam situasi berikut:

  • Melihat link berdasarkan rentang waktu
  • Menyaring link berdasarkan kriteria tertentu
  • Menampilkan daftar link di dashboard admin
  • Mendukung analitik atau integrasi data
Gabungkan filter untuk mendapatkan data yang dibutuhkan dengan cepat.

Kemampuan pencarian

Filter fleksibel untuk kebutuhan skala besar.

  • Rentang waktu: Cari berdasarkan periode pembuatan
  • Paginasi: Ambil data per halaman dengan parameter pages
  • Filter: Saring berdasarkan linkId, domain, grup, dan lainnya
  • Filter status: Berdasarkan tipe pembuatan, pengaturan, dan atribut lainnya
Dirancang untuk menangani data besar dengan cepat dan efisien.

Contoh penggunaan

Dirancang untuk kebutuhan operasional skala besar.

  • E-commerce: Ambil link berdasarkan periode dan sinkronkan dengan sistem stok
  • Iklan: Filter berdasarkan grup kampanye (grpIdx) untuk memantau performa per channel
  • Otomatisasi: Deteksi link yang akan kedaluwarsa untuk diperbarui atau dihapus
  • Analisis: Ekspor data ke alat BI dan gabungkan dengan data klik
Penting untuk layanan dengan volume data besar.

Hal yang perlu diperhatikan

Periksa hal berikut sebelum melakukan pencarian.

  • Rentang waktu yang luas dapat meningkatkan waktu respons
  • Maksimal 30 data per halaman—gunakan pagination untuk mengambil seluruh data
  • Semakin banyak filter, hasil akan semakin terbatas
  • Pertimbangkan beban server saat memproses data besar
Gunakan rentang pencarian yang tepat untuk menjaga performa tetap stabil.