# 入門指南

了解如何使用 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="https://637457805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbV8SoKVnOm2o3eQR4D1v%2Fuploads%2Fz60EvjdBGAl0EBvXlrr5%2F%E7%99%BB%E5%BD%95-%E7%B9%81%E4%B8%AD.png?alt=media&#x26;token=5fdd5311-9a4c-4feb-bbb8-ec9274d25661" 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="https://637457805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbV8SoKVnOm2o3eQR4D1v%2Fuploads%2FRtdYKBhuqN20F27OBcZZ%2F%E5%95%86%E5%BA%97-%E9%80%89%E6%8B%A9-%E7%B9%81%E4%B8%AD.png?alt=media&#x26;token=d30e4be8-57ff-44f7-b085-39d2e146128c" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="https://637457805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbV8SoKVnOm2o3eQR4D1v%2Fuploads%2FxE2lFq7gTD12HJGzetxO%2F%E6%A6%82%E8%A7%88-%E7%B9%81%E4%B8%AD.png?alt=media&#x26;token=233c5890-9fac-47df-84f5-90c1385ec794" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="https://637457805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbV8SoKVnOm2o3eQR4D1v%2Fuploads%2FJZPMOghbYY4V8DFEn4YT%2F%E6%9E%84%E5%BB%BA%E5%99%A8-%E5%8F%82%E6%95%B0-%E7%B9%81%E4%B8%AD.png?alt=media&#x26;token=166de9d1-03ab-49a9-bc69-b2eeb0df6195" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://637457805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbV8SoKVnOm2o3eQR4D1v%2Fuploads%2FhbXZVRfYlNrTTWGr647f%2F%E6%9E%84%E5%BB%BA%E5%99%A8-%E5%8F%82%E6%95%B0-%E6%93%8D%E4%BD%9C-%E7%B9%81%E4%B8%AD.png?alt=media&#x26;token=caafedc1-0817-4c1d-997e-18ee751a0692" 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="https://637457805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbV8SoKVnOm2o3eQR4D1v%2Fuploads%2F4kzNZN8Qzb9jwkgyE63Z%2F%E6%9E%84%E5%BB%BA%E5%99%A8-%E5%91%BD%E4%BB%A4-%E7%B9%81%E4%B8%AD.png?alt=media&#x26;token=2423174d-a580-4b11-874d-0c0574787909" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="https://637457805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbV8SoKVnOm2o3eQR4D1v%2Fuploads%2FQf3Fhxv4DgQDurNqengh%2F%E4%BB%BB%E5%8A%A1-%E7%B9%81%E4%B8%AD.png?alt=media&#x26;token=dabd0d32-88ba-40e6-8b3a-ee7722f0d1a0" alt="" width="563"><figcaption></figcaption></figure></div>

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