링크 목록

생성된 단축 링크 목록을 조회하는 API입니다.

이 API는 프리미엄 요금제 이상에서만 제공됩니다.

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
링크 생성일(시작일). 조회 시작일을 지정합니다.
예: 2025-09-01 00:00:00
regEndYmdtdatetimerequired
링크 생성일(종료일). 조회 종료일을 지정합니다.
예: 2025-09-10 23:59:59
pagesintegerrequired
페이지 번호. 조회 결과의 페이지 번호입니다. 기본값은 1입니다.
한 페이지에는 기본 30개의 결과가 반환되며, pages=2인 경우 31번째 결과부터 30개가 반환됩니다.
linkIdstring
링크ID.
domainstring
링크 도메인.
createTypeIdxinteger
Default:0
Enum:
0270272274
링크 생성 방식. 0:모든 링크, 270:대시보드에서 생성한 링크, 272:API 호출로 생성한 링크, 274:엑셀 업로드로 생성한 링크.
grpIdxinteger
링크 그룹.
urlstring
원본 URL. 부분 검색이 가능합니다.
ttlstring
링크 제목. 부분 검색이 가능합니다.
공백이나 유니코드가 포함되어 있을 경우, URL Encoding을 권장합니다.
brandLinkYnstring
Default:N
Enum:
YN
브랜드 링크 여부.
memostring
링크 관리용 메모. 부분 검색이 가능합니다.
공백이나 유니코드가 포함되어 있을 경우, URL Encoding을 권장합니다.
notfSubscYnstring
Default:N
Enum:
YN
푸시구독 링크 여부.
blockOverseasSticsYnstring
Default:N
Enum:
YN
해외통계 차단 여부.
pushNotifyYnstring
Default:N
Enum:
YN
클릭 수 푸시 알림 여부.
mailNotifyYnstring
Default:N
Enum:
YN
클릭 수 메일 알림 여부.
startDelYmdtdatetime
링크 삭제 예약 시작일시.
endDelYmdtdatetime
링크 삭제 예약 종료일시. 
{
    "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
응답 코드: 0 = 성공, 그 외 값 = 오류
messagestring
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
resultobject
extraobject
페이지 및 데이타 건수 정보.
pagesinteger
현재 페이지 번호
nextPagesinteger
다음 페이지 번호
nextYnstring
다음 페이지 존재 여부
countinteger
현재 페이지의 데이터 건수
totalCountinteger
전체 데이터 건수
listarray
링크 정보
linkIdstring
링크ID.
domainstring
도메인.
typeIdxinteger
Default:103
Enum:
103104106107108119447
링크 유형(IDX). 103:URL, 104:게시물, 106:딥링크, 107:버튼, 108:카드, 119:QR, 447:Form.
typeNmstring
링크 유형(이름).
ttlstring
링크 제목.
memostring
링크 관리용 메모.
linkIdstring
링크ID.
urlstring
단축 URL
grpIdxinteger
링크 그룹(IDX).
grpNmstring
링크 그룹(이름).
acesCntinteger
클릭 수.
acesCntTodayinteger
오늘 클릭 수.
lastClkYmdtdatetime
마지막 클릭 날짜
longUrlstring
원본 URL.
longUrlstring
원본 URL
notfSubscYnstring
Default:N
Enum:
YN
푸시구독 링크 여부.
blockOverseasSticsYnstring
Default:N
Enum:
YN
해외통계 차단 여부.
pushNotifyYnstring
Default:N
Enum:
YN
클릭 수 푸시 알림 여부.
mailNotifyYnstring
Default:N
Enum:
YN
클릭 수 메일 알림 여부.
delYmdtdatetime
링크 삭제 예약 일시.
regYmdtdatetime
생성 날짜
modYmdtdatetime
수정 날짜