获取即时表单或私信线索的字段值

您可以使用本接口获取即时表单或私信线索的字段值。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/lead/field/get/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| lead_source  {必填}| string | 线索来源。<br><br>枚举值：<ul><li>`INSTANT_FORM`：通过即时表单生成的线索。</li><li>`DIRECT_MESSAGE`：通过绑定的企业号的私信生成的线索。</li></ul> |
| advertiser_id  {+条件必填} | string | 线索在广告账户中时，本字段必填。<br><br>广告账号 ID。 |
| library_id  {+条件必填} | string | 线索在商务中心中的表单库中时，本字段必填。<br><br>表单库 ID。<br><br>若想获取某一商务中心中的表单库列表，可使用[/page/library/get/](1740029915327489.html)。 |
| page_id  {+条件必填} | string | <ul><li>`lead_source` 为 `INSTANT_FORM`时必填。</li><li>`lead_source` 为 `DIRECT_MESSAGE` 时不支持本字段。</li></ul><br>即时表单的页面 ID。<br><br>若想获取即时表单列表，可使用[/page/get/](1820826387779586.html)并将 `business_type` 设置为 `LEAD_GEN`。 |

示例

获取即时表单的字段

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/lead/field/get/?advertiser_id={{advertiser_id}}&lead_source=INSTANT_FORM&page_id={{page_id}}' \
--header 'Access-token: {{Access-token}}'
(/code)

#### 获取私信线索的字段

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/lead/field/get/?advertiser_id={{advertiser_id}}&lead_source=DIRECT_MESSAGE' \
--header 'Access-token: {{Access-token}}'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述，参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志 ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#| fields | string[] | 即时表单或私信线索的字段信息。<br><br><p><span style="color:darkred"><b>注意</b></span>：本字符串数组中的数据取决于即时表单中设置的问题或私信线索收集的问题。 |
#| meta_data | object | 即时表单或私信线索的元信息。 |
##| create_time | string | 即时表单的创建时间或私信线索的收集时间，格式为 `YYYY-MM-DD HH:MM:SS` （UTC+0 时间）。<br><br>示例：`2025-01-01 00:00:01`。 |
##| page_id | string | 即时表单的页面 ID。<br><br>请求中 `lead_source` 为 `DIRECT_MESSAGE` 时，本字段将为 `"0"`。 |
##| page_name | string | 即时表单的页面名称。<br><br>请求中 `lead_source` 为 `DIRECT_MESSAGE` 时，本字段将为空字符串（`""`）。 |
##| page_url | string | 即时表单的 URL。<br><br>请求中 `lead_source` 为 `DIRECT_MESSAGE` 时，本字段将为空字符串（`""`）。 |

示例

获取即时表单的字段

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "fields": [
            "email"
        ],
        "meta_data": {
            "create_time": "{{create_time}}",
            "page_id": "{{page_id}}",
            "page_name": "{{page_name}}",
            "page_url": "{{page_url}}"
        }
    }
}
(/code)

获取私信线索的字段

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "fields": [
            "name",
            "tiktok",
            "email",
            "phone_number"
        ],
        "meta_data": {
            "create_time": "{{create_time}}",
            "page_id": "0",
            "page_name": "",
            "page_url": ""
        }
    }
}
(/code)