API（資料）
API 是什麼？
應用程式介面（Application Programming Interface）的縮寫，是一系列規則或協定，使不同軟體程式能夠交換資料並相互互動。
當您想將 Listly 提取的資料存入自己的資料庫（DB）或連動到 Google 試算表時，可以使用。
TIP 連動到 Google 試算表
超簡單跟著做
➡️ 選擇想要的資料提取結果 ➡️ 點擊 API 按鈕 ➡️ （首次使用時）生成 Token ➡️ 取得 API Token 和 API 位址
確認 API 位址的方法
LISTLY API 可以想像成一種將提取的資料傳送到想要的地方的資料連接通道（pipeline）。如下圖所示，所有資料結果頁面都有 API 按鈕，按下 API 按鈕會出現指向該結果的 API 位址。連線到該位址時，會出現與 Excel 收到的資料相同的內容。可以利用此功能連動到 Google 試算表，或撰寫額外的程式碼將資料放入自己的資料庫。
首次使用 API 按鈕的人會如下圖出現 API Token 生成畫面。點擊一次生成 Token，回到結果頁面再按一次 API 按鈕。
如果已經設定過，可以在帳號設定確認 API Token。
API 位址種類
API 位址大致有 2 種。
最新 API：只顯示提取成功的最新資料。
記錄 API：顯示至今提取的所有資料。
在單一（Single）、群組（Group）提取結果頁面可以使用所有最新、記錄 API。
最新 API 回應訊息出現 {"message": "Warning! Do not use this API endpoint..."}
此訊息在提取的網頁設計變更時出現。資料提取仍會自動正常進行，但這是一種通知網頁已變更的警告訊息。使用排程器功能自動收集時發生機率較高。
原則上建議在 LISTLY 擴充功能重新提取。因為網頁設計變更了，長期來看建立新基準點較好。重新提取資料建立新起點，再重新設定排程器，從那時起就能穩定使用最新 API。
如果想忽略警告繼續使用現有資料，可以使用上述訊息中 "api_endpoint" 區域出現的位址。此時會出現提取的最新資料，"api_endpoint" 出現的位址是現有 API 位址 + 忽略警告訊息的選項（&ignore_warning=y）的總和值。
API Endpoint 介紹
所有 API 位址都可以在圖中所示的資料提取結果頁面確認。
Single (最新)
www.listly.io/api/single?key=<singlekey>
GET
顯示最新資料。用於接收排程器自動提取的最新資料。
Single (記錄)
www.listly.io/api/single/data?key=<datakey>
GET
顯示所有記錄資料。用於一次取得至今累積的所有資料進行檢查。
Group (最新)
www.listly.io/api/group?key=<groupkey>
GET
顯示最新群組資料。
Group (記錄)
www.listly.io/api/group/data?key=<datakey>
GET
顯示選擇的資料所屬批次（batch）群組的所有資料。每累積新群組資料，批次（batch）會增加 1。
API Parameter 介紹
Single (最新) 資料 API
www.listly.io/api/single?key=<singlekey>&selected=1&arrange=y&href=n&file=csv
Single (記錄) 資料 API
www.listly.io/api/single?key=<datakey>&selected=1&arrange=y&href=n&stack=vertical&file=csv
<datakey> 指使用者複製 API 位址時開啟的資料結果。以該資料選擇的分頁為基準，從最新或記錄資料取得相同資料。
selected
int
1, 2, 3...
1
選擇的分頁位置。 1 表示第 1 個，2 表示第 2 個。
arrange
string
y, n
y
資料自動排序選項。 y 為自動排序。 n 為無自動排序，按出現順序從左側依序輸出。
href
string
y, n
n
包含超連結選項。 y 為包含超連結。 n 為不包含。
stack
string
vertical, horizontal
vertical
資料堆疊方法。 vertical 為從上到下垂直堆疊。 horizontal 為從左到右水平堆疊。
file
string
csv, json
json
資料輸出格式。
from
datetime
2020-11-01T00:00
可以用日期時間限制資料範圍。 from 為開始時點。 %Y-%m-%dT%H:%M 表示。
to
datetime
2020-11-11T23:59
可以用日期時間限制資料範圍。 to 為結束時點。 %Y-%m-%dT%H:%M 表示。
TIP 如果上述說明不易理解，請在實際 API 位址直接更改選項值試試看。可以立即確認如何變更。
程式碼範例
Python 程式碼格式
Python 程式碼實際範例
Was this helpful?