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}®EndYmdt={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.