> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/zh-hk/web-scraper-api/ru-men-zhi-nan.md).

# 入門指南

了解如何使用 Web Scraper API 建構器或以程式化方式執行抓取工具。\
請注意，使用我們的 Web Scraper API 時，您需要擁有一個 Thordata 帳戶。如果您還沒有帳戶，請先完成[註冊](https://dashboard.thordata.com/zh-hk/register)。如果您已經了解如何使用，可以直接前往儀表板[登入](https://dashboard.thordata.com/zh-hk/login)並使用。

<div align="left"><figure><img src="/files/Grrpn4THgeAwhrz4hTTk" alt="" width="563"><figcaption></figcaption></figure></div>

1. **選擇您的第一個抓取工具**   \
   登入 Thordata 儀表板後，導航至 [Web Scraper 商店](https://dashboard.thordata.com/zh-hk/web-scraper)。   \
   要獲取您的第一個抓取文件，您必須從 Web Scraper 商店選擇一個現有的抓取器。   \
   在本文中，我們將以\[Amazon - 透過 URL 收集產品信息]作為示例。選擇好抓取器後，您可以通過多種方式啟動它。

<div align="left"><figure><img src="/files/4UfguKil6G1J6AM48oaf" alt="" width="563"><figcaption></figcaption></figure></div>

2. **了解您的第一個抓取工具**   \
   選擇您的第一個抓取器後，您將被引導到一個新頁面。在這個頁面上，您可以查看該抓取器的多個詳細信息，包括介紹、示例 JSON/CSV 輸出、示例輸出中字段的解釋，以及運行該抓取器所需的輸入參數說明。   \
   此外，如果抓取器未包含您需要的字段，您可以通過缺失數據點處的反饋入口或頁面底部的反饋區提供意見。我們將在 24 小時內與您聯繫，幫助解決問題。

<div align="left"><figure><img src="/files/VVXT0hBsRqUN3h68sWXH" alt="" width="563"><figcaption></figcaption></figure></div>

3. **使用您的第一個抓取工具**   \
   ① 透過 API 建構器進行抓取：   \
   將您想要抓取的亞馬遜產品詳細鏈接替換到 API 建構器中的「URLs」位置，然後點擊「開始抓取」。

<div align="left"><figure><img src="/files/Hj34ebWq7yptQXuY04zF" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/0dFxCtcegf8fCF6O7L2M" alt="" width="563"><figcaption></figcaption></figure></div>

&#x20;      ② 透過程式化方式進行抓取：\
&#x20;       通過使用右側的代碼發送 POST 請求來調用抓取工具。例如：

{% tabs %}
{% tab title="cURL-Linux" %}

```sh
curl -X POST "https://scraperapi.thordata.com/builder" \
  -H "Authorization: Bearer Token-ID" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "spider_name=amazon.com" \
  -d "spider_id=amazon_product_by-url" \
  -d "spider_parameters=[{\"url\": \"https://www.amazon.com/HISDERN-Checkered-Handkerchief-Classic-Necktie/dp/B0BRXPR726\",\"zip_code\": \"94107\"}]" \
  -d "spider_errors=true" \
  -d "file_name={{TasksID}}"
```

{% endtab %}

{% tab title="cURL-Windows" %}

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=amazon.com" ^
  -d "spider_id=amazon_product_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.amazon.com/HISDERN-Checkered-Handkerchief-Classic-Necktie/dp/B0BRXPR726\",\"zip_code\": \"94107\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

{% endtab %}
{% endtabs %}

<div align="left"><figure><img src="/files/oACRpuMQKcy8fguq4TqV" alt="" width="563"><figcaption></figcaption></figure></div>

4. **獲取結果與歷史抓取記錄**   \
   網頁抓取器可能需要一些時間來完成操作，請耐心等待。   \
   您很快就會看到您創建的第一個任務成功完成。您可以通過「任務」列表中的下載按鈕以多種格式導出數據。當然，如果在抓取完成後直接關閉了抓取頁面，但仍然希望查看歷史抓取內容，您可以通過抓取器的「任務」列表查看所有歷史抓取記錄。

<div align="left"><figure><img src="/files/WOa4koNXvb4AXCUB7fOF" alt="" width="563"><figcaption></figcaption></figure></div>

如果您需要進一步的幫助，請通過電子郵件聯繫 <support@thordata.com>。
