Lista de enlaces

API para consultar la lista de enlaces cortos generados.

Esta API solo está disponible en planes Premium o superiores.

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
Fecha de creación del enlace (Inicio). Especifica la fecha de inicio de la consulta.
Ejemplo: 2025-09-01 00:00:00
regEndYmdtdatetimerequired
Fecha de creación del enlace (Fin). Especifica la fecha de fin de la consulta.
Ejemplo: 2025-09-10 23:59:59
pagesintegerrequired
Número de página. El valor por defecto es 1.
Cada página devuelve 30 resultados. Por ejemplo, si pages=2, devuelve desde el registro 31.
linkIdstring
ID del enlace.
domainstring
Dominio del enlace.
createTypeIdxinteger
Método de creación del enlace.
0: Todos los enlaces, 270: Creado desde el panel, 272: Creado vía API, 274: Creado por carga de Excel.
grpIdxinteger
Grupo de enlaces.
urlstring
URL original. Se admite búsqueda parcial.
ttlstring
Título del enlace. Se admite búsqueda parcial.
Si incluye espacios o caracteres Unicode, se recomienda la codificación URL.
brandLinkYnstring
Indica si es un enlace de marca.
memostring
Nota para la gestión del enlace. Se admite búsqueda parcial.
Si incluye espacios o caracteres Unicode, se recomienda la codificación URL.
notfSubscYnstring
Indica si es un enlace de suscripción push.
blockOverseasSticsYnstring
Indica si se bloquean las estadísticas en el extranjero.
pushNotifyYnstring
Indica si las notificaciones push de clics están activadas.
mailNotifyYnstring
Indica si las notificaciones por correo de clics están activadas.
startDelYmdtdatetime
Fecha y hora de inicio de la eliminación del enlace.
endDelYmdtdatetime
Fecha y hora de finalización de la eliminación del enlace.
{
    "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
Código de respuesta: 0 = Éxito, otros valores = Error
messagestring
Mensaje de respuesta. Si el código no es 0, se devuelve un mensaje de error.
resultobject
extraobject
Información de página y número de datos.
pagesinteger
Número de la página actual
nextPagesinteger
Número de la siguiente página
nextYnstring
Indica si existe una página siguiente
countinteger
Número de registros en la página actual
totalCountinteger
Número total de registros
listarray
Información del Enlace
linkIdstring
ID del enlace.
domainstring
Dominio.
typeIdxinteger
Default:103
Enum:
103104106107108119447
Tipo de enlace (IDX). 103: URL, 104: Publicación, 106: Enlace Profundo, 107: Botón, 108: Tarjeta, 119: QR, 447: Formulario.
typeNmstring
Tipo de enlace (Nombre).
ttlstring
Título del enlace.
memostring
Nota para la gestión del enlace.
urlstring
URL corta.
grpIdxinteger
Grupo de enlaces (IDX).
grpNmstring
Grupo de enlaces (Nombre).
acesCntinteger
Número total de clics.
acesCntTodayinteger
Clics de hoy.
lastClkYmdtdatetime
Fecha del último clic.
longUrlstring
URL original.
notfSubscYnstring
Indica si es un enlace de suscripción push.
blockOverseasSticsYnstring
Indica si se bloquean las estadísticas en el extranjero.
pushNotifyYnstring
Indica si están habilitadas las notificaciones push de clics.
mailNotifyYnstring
Indica si están habilitadas las notificaciones por correo electrónico de clics.
delYmdtdatetime
Fecha programada de eliminación del enlace.
regYmdtdatetime
Fecha de creación.
modYmdtdatetime
Fecha de modificación.