API（数据）

数据访问 API

通过 API 访问提取的数据。

---

获取数据

GET https://api.listly.io/v1/tasks/{task_id}/data

响应格式

默认返回 JSON：

{
  "task_id": "abc123",
  "data": [
    {
      "title": "商品A",
      "price": "¥100",
      "url": "https://example.com/product-a"
    },
    {
      "title": "商品B",
      "price": "¥200",
      "url": "https://example.com/product-b"
    }
  ],
  "total_rows": 2
}

---

格式选项

通过查询参数指定格式：

GET https://api.listly.io/v1/tasks/{task_id}/data?format=csv
GET https://api.listly.io/v1/tasks/{task_id}/data?format=xlsx
GET https://api.listly.io/v1/tasks/{task_id}/data?format=json

---

分页

GET https://api.listly.io/v1/tasks/{task_id}/data?limit=100&offset=0

参数

• limit - 每页行数（最大1000）

• offset - 起始行

---

过滤数据

GET https://api.listly.io/v1/tasks/{task_id}/data?fields=title,price

只返回指定字段。

---

示例代码

Python

import requests

url = "https://api.listly.io/v1/tasks/abc123/data"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

response = requests.get(url, headers=headers)
data = response.json()

for row in data['data']:
    print(row['title'], row['price'])

JavaScript

---

下载文件

直接下载文件格式：

GET https://api.listly.io/v1/tasks/{task_id}/download?format=xlsx

返回文件流，可直接保存。

---

相关文档

• API - 状态

• 企业版