Linkliste

API zum Abrufen der Liste der erstellten Kurz-URLs.

Diese API ist nur in Premium-Tarifen oder höher verfügbar.

GET

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

{
    "regStartYmdt": "2025-09-01 00:00:00",
    "regEndYmdt": "2025-09-10 23:59:59",
    "pages": 1
}

Request Parameters

regStartYmdtdatetimerequired
Link-Erstellungsdatum (Start). Gibt das Startdatum der Abfrage an.
Beispiel: 2025-09-01 00:00:00
regEndYmdtdatetimerequired
Link-Erstellungsdatum (Ende). Gibt das Enddatum der Abfrage an.
Beispiel: 2025-09-10 23:59:59
pagesintegerrequired
Seitennummer. Standardwert ist 1.
Jede Seite liefert standardmäßig 30 Ergebnisse. Wenn pages=2, werden die Ergebnisse ab dem 31. Eintrag zurückgegeben.
linkIdstring
Link-ID.
domainstring
Link-Domain.
createTypeIdxinteger
Methode der Link-Erstellung.
0: Alle Links, 270: Über Dashboard erstellt, 272: Über API erstellt, 274: Über Excel-Upload erstellt.
grpIdxinteger
Link-Gruppe.
urlstring
Original-URL. Teilweise Suche wird unterstützt.
ttlstring
Link-Titel. Teilweise Suche wird unterstützt.
Wenn Leerzeichen oder Unicode-Zeichen enthalten sind, wird URL-Encoding empfohlen.
brandLinkYnstring
Ob es sich um einen Markenlink handelt.
memostring
Notiz zur Linkverwaltung. Teilweise Suche wird unterstützt.
Wenn Leerzeichen oder Unicode-Zeichen enthalten sind, wird URL-Encoding empfohlen.
notfSubscYnstring
Ob es sich um einen Push-Abonnement-Link handelt.
blockOverseasSticsYnstring
Ob Auslandsstatistiken blockiert werden.
pushNotifyYnstring
Ob Push-Benachrichtigungen für Klicks aktiviert sind.
mailNotifyYnstring
Ob E-Mail-Benachrichtigungen für Klicks aktiviert sind.
startDelYmdtdatetime
Startdatum und -uhrzeit der Linklöschung.
endDelYmdtdatetime
Enddatum und -uhrzeit der Linklöschung. 
{
    "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",
                "ttl": "Add YouTube videos using post links to create short links",
                "memo": "",
                "url": "https://vvd.im/createpostinglinks",
                "grpIdx": 0,
                "grpNm": "",
                "acesCnt": 5072,
                "acesCntToday": 315,
                "lastClkYmdt": "2022-11-07 04:45:10",
                "longUrl": "https://vivoldi.com/blog/url-shortener/create-posts-link-url-shortener",
                "blockOverseasSticsYn": "N",
                "notfSubscYn": "N",
                "kakaoNotifyYn": "N",
                "pushNotifyYn": "N",
                "mailNotifyYn": "N",
                "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",
                "ttl": "NAVER",
                "memo": "",
                "url": "https://vvd.bz/4Rth",
                "grpIdx": 128,
                "grpNm": "Test",
                "acesCnt": 19,
                "acesCntToday": 3,
                "lastClkYmdt": "2022-11-07 17:20:40",
                "longUrl": "https://www.naver.com",
                "blockOverseasSticsYn": "N",
                "notfSubscYn": "N",
                "kakaoNotifyYn": "N",
                "pushNotifyYn": "Y",
                "mailNotifyYn": "N",
                "delYmdt": "2025-12-31 23:59:59",
                "regYmdt": "2022-11-07 17:10:22",
                "modYmdt": "2022-11-07 17:10:22"
            }
        ]
    }
}

Response Parameters

codeinteger
Antwortcode: 0 = Erfolg, andere Werte = Fehler
messagestring
Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
resultobject
extraobject
Informationen zu Seiten und Datensätzen.
pagesinteger
Aktuelle Seitennummer
nextPagesinteger
Nächste Seitennummer
nextYnstring
Ob eine nächste Seite existiert
countinteger
Anzahl der Datensätze auf der aktuellen Seite
totalCountinteger
Gesamtanzahl der Datensätze
listarray
Link-Informationen
linkIdstring
Link-ID.
domainstring
Domain.
typeIdxinteger
Default:103
Enum:
103104106107108119447
Link-Typ (IDX). 103: URL, 104: Beitrag, 106: Deep-Link, 107: Button, 108: Karte, 119: QR, 447: Formular.
typeNmstring
Link-Typ (Name).
ttlstring
Link-Titel.
memostring
Notiz für die Linkverwaltung.
urlstring
Kurz-URL.
grpIdxinteger
Link-Gruppe (IDX).
grpNmstring
Link-Gruppe (Name).
acesCntinteger
Gesamtanzahl der Klicks.
acesCntTodayinteger
Klicks heute.
lastClkYmdtdatetime
Datum des letzten Klicks.
longUrlstring
Original-URL.
notfSubscYnstring
Ob es sich um einen Push-Abonnement-Link handelt.
blockOverseasSticsYnstring
Ob Auslandsstatistiken blockiert werden.
pushNotifyYnstring
Ob Push-Benachrichtigungen für Klicks aktiviert sind.
mailNotifyYnstring
Ob E-Mail-Benachrichtigungen für Klicks aktiviert sind.
delYmdtdatetime
Geplantes Löschdatum des Links.
regYmdtdatetime
Erstellungsdatum.
modYmdtdatetime
Änderungsdatum.