API (datos)
¿Qué es una API?
Es la abreviatura de Interfaz de Programación de Aplicaciones (Application Programming Interface), un conjunto de reglas o protocolos que permiten a diferentes programas de software intercambiar datos e interactuar entre sí.
Usa esto cuando quieras almacenar los datos extraídos con Listly en tu propia base de datos o conectarlos a Google Sheets.
CONSEJO Cómo conectar con Google Sheets
Referencia: Importar datos recopilados en Google Sheets (Integración API)
Guía rápida y sencilla
➡️ Selecciona el resultado de extracción deseado ➡️ Haz clic en el botón API ➡️ (Si es la primera vez) Genera un token ➡️ Obtén el token API y la dirección API
Cómo verificar la dirección API
La API de LISTLY puede considerarse como un conducto de datos (pipeline) para transferir datos extraídos a donde los necesites. Como se muestra en la imagen a continuación, cada página de resultados de datos tiene un botón API, y al hacer clic en él, aparece la dirección API correspondiente a ese resultado. Al acceder a esa dirección, verás los mismos datos que recibirías en Excel. Puedes usar esta función para conectarla a Google Sheets o escribir código adicional para insertar los datos en tu propia base de datos.
Para quienes usan el botón API por primera vez, aparecerá una pantalla de generación de token API como se muestra en la imagen a continuación. Genera el token con un clic y regresa a la página de resultados para hacer clic nuevamente en el botón API.
Si ya has configurado esto antes, puedes verificar tu token API en la configuración de la cuenta.
Tipos de direcciones API
Hay principalmente 2 tipos de direcciones API:
API más reciente: Muestra solo los datos extraídos con éxito más recientes.
API de registro: Muestra todos los datos extraídos hasta ahora.
Puedes usar tanto las APIs más recientes como las de registro en las páginas de resultados de extracción Single (Individual) y Group (Grupal).
El mensaje de respuesta de la API más reciente es {"message": "Warning! Do not use this API endpoint..."}
Este mensaje aparece cuando el diseño de la página web que estás extrayendo ha cambiado. La extracción de datos sigue funcionando automáticamente bien, pero es un mensaje de advertencia que te informa que la página web ha cambiado. Es más probable que ocurra cuando usas la función de programador para recopil ar automáticamente.
En principio, recomendamos extraer de nuevo desde la extensión de LISTLY. Como el diseño de la página web ha cambiado, es mejor crear un nuevo punto de referencia a largo plazo. Si extraes los datos de nuevo para crear un nuevo punto de partida y vuelves a configurar el programador, podrás usar la API más reciente de forma estable desde ese momento.
Si deseas ignorar la advertencia y seguir usando los datos existentes, puedes usar la dirección que aparece en el área "api_endpoint" en el mensaje anterior. En este caso, aparecerán los datos más recientes extraídos, y la dirección que aparece en "api_endpoint" es la dirección API original + una opción que ignora el mensaje de advertencia (&ignore_warning=y).
Introducción a los API Endpoints
Todas las direcciones API se pueden verificar en la página de resultados de extracción de datos como se muestra en la imagen.
Single (más reciente)
www.listly.io/api/single?key=<singlekey>
GET
Muestra los datos más recientes. Se usa para recibir los datos más recientes que se extraen automáticamente mediante el programador.
Single (registro)
www.listly.io/api/single/data?key=<datakey>
GET
Muestra todos los datos de registro. Se usa para importar todos los datos acumulados de una vez y revisarlos.
Group (más reciente)
www.listly.io/api/group?key=<groupkey>
GET
Muestra los datos de grupo más recientes.
Group (registro)
www.listly.io/api/group/data?key=<datakey>
GET
Muestra todos los datos del lote (batch) del grupo al que pertenecen los datos seleccionados. El lote (batch) aumenta en 1 cada vez que se acumulan nuevos datos de grupo.
Introducción a los parámetros API
API de datos Single (más recientes)
www.listly.io/api/single?key=<singlekey>&selected=1&arrange=y&href=n&file=csv
API de datos Single (registro)
www.listly.io/api/single?key=<datakey>&selected=1&arrange=y&href=n&stack=vertical&file=csv
<datakey> se refiere al resultado de datos que estaba abierto cuando el usuario copió la dirección API. Basándose en la pestaña seleccionada en esos datos, extrae datos idénticos de los datos más recientes o de registro.
selected
int
1, 2, 3...
1
Es la posición de la pestaña seleccionada. 1 significa primero, 2 significa segundo.
arrange
string
y, n
y
Opción de ordenamiento automático de datos. y ordena automáticamente. n imprime en el orden de aparición sin ordenamiento automático, de izquierda a derecha.
href
string
y, n
n
Opción de inclusión de hipervínculos. y incluye hipervínculos. n no los incluye.
stack
string
vertical, horizontal
vertical
Método de apilamiento de datos. vertical apila verticalmente de arriba hacia abajo. horizontal apila horizontalmente de izquierda a derecha.
file
string
csv, json
json
Formato de salida de datos.
from
datetime
2020-11-01T00:00
Puedes limitar el rango de datos por fecha y hora. from es el punto de inicio. Se expresa como %Y-%m-%dT%H:%M.
to
datetime
2020-11-11T23:59
Puedes limitar el rango de datos por fecha y hora. to es el punto final. Se expresa como %Y-%m-%dT%H:%M.
CONSEJO Si las explicaciones anteriores no te quedan claras, prueba cambiando los valores de las opciones directamente en la dirección API real. Podrás ver cómo cambia inmediatamente.
Ejemplos de código
Formato de código Python
Ejemplo real de código Python
Última actualización
¿Te fue útil?