> ## 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.