> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 獲取小組件線索列表

> 分頁獲取由某個小組件採集到的線索。

## 身份驗證

需要提供 Bearer 令牌（API 密鑰）或儀表盤會話。

## 路徑參數

<ParamField path="id" type="string" required>
  小組件配置的 UUID。
</ParamField>

## 查詢參數

<ParamField query="limit" type="number" default="50">
  每頁大小（最大 200）。
</ParamField>

<ParamField query="offset" type="number" default="0">
  要跳過的線索數量。
</ParamField>

<ParamField query="search" type="string">
  與已採集線索字段進行不區分大小寫的匹配。
</ParamField>

<ParamField query="from" type="string">
  ISO 時間戳下限（包含該時間點）。
</ParamField>

<ParamField query="to" type="string">
  ISO 時間戳上限（包含該時間點）。
</ParamField>

## 響應

<ResponseField name="leads" type="array">
  每條線索包含：`id`、`lead_data`（已採集的字段）、`session_id`、`ip_country`、`referrer_url`、`created_at`。
</ResponseField>

<ResponseField name="total" type="number">
  符合篩選條件的線索總數。
</ResponseField>

<ResponseField name="limit" type="number" />

<ResponseField name="offset" type="number" />

## 示例

```bash curl theme={null}
curl "https://www.hitheo.ai/api/v1/iframes/CONFIG_ID/leads?limit=50" \
  -H "Authorization: Bearer $THEO_API_KEY"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.