伶俐数据 API 快速开始

首次接入从确认接口与费用开始。准备好自己的服务端环境，再按当前文档配置密钥和请求参数。

接入前先核对这三项

1. 阅读调用前费用与使用条件，确认本次验证允许的范围。
2. 按密钥与鉴权说明准备服务端配置。
3. 使用API 接入检查清单记录响应处理、失败恢复和验收结果。

如果你要评估的是 Facebook 帖子搜索，可结合该接口的公开说明阅读下面的示例。其他接口需要采用各自文档，不能只替换请求地址后照搬参数。

创建账户并选择接口

前往登录与注册入口，完成页面要求的注册和身份确认。在 API 市场选择适合业务需求的接口，检查请求方法、参数、响应说明、计费条件和调用限制。

记录本次接入要验证的内容，例如“是否能按指定主题获得文档约定的字段”。不要把接口名称或营销介绍当成完整协议。

在服务端准备密钥

在用户中心创建密钥，将其保存为服务端的 LINGLI_API_KEY 环境变量。真实值不要进入源代码、公开配置、浏览器脚本或截图。

下面的 Python 请求沿用官网公开示例。运行前需安装 requests、配置自己的环境变量，并核对接口当前状态和费用。示例用于说明请求结构，运行会产生真实请求，请先核对费用。

import os
import requests

response = requests.get(
    "https://api.linglis.com/api/facebook/search/posts",
    headers={"X-API-Key": os.environ["LINGLI_API_KEY"]},
    params={"query": "technology"},
    timeout=30,
)
response.raise_for_status()
data = response.json()

检查响应后再接入业务

HTTP 成功只说明请求在 HTTP 层得到正常响应，仍要按文档检查业务结果。确认字段含义、空结果处理和数据使用范围后，再编写后续业务逻辑。

需要获取更多结果时，先查明接口是否提供分页、如何继续下一页和何时停止。示例未展示分页，不应自行假设 page、offset 或 cursor 参数存在。

请求失败时

先核对请求地址、方法、必填参数和密钥配置，再查看控制台中的可用状态、费用条件及文档说明。保持失败日志脱敏。自动重试需要考虑计费与重复调用风险，不能把所有失败都直接重发。

查看当前接口详情

怎样判断首次接入准备已经完成

记录所读文档的日期、选用接口、密钥存放位置、预期业务结果及失败时的处理方式。若已经进行获准的真实调用，再保存脱敏后的实际结果；没有调用时写明“尚未验证”。本页示例没有给出响应样本，不能据此假定成功标识、数据字段或分页标记。

下一步在控制台查看当前接口详情，按已确认的条件完成自己的验证。读者运行示例会产生真实网络请求；本页的文档检查没有替你执行收费调用。