💡 如果您正在摆脱电子表格或已经拥有适当的分析系统，您可以使用我们的API自动获取所需的数据，而无需每隔一段时间导入CSV文件。
💡 请注意，我们的API仅支持GET方法。这意味着您无法使用API删除或添加域名或广告格式。
获取API令牌
要获取API令牌，请从左侧菜单中进入API页面，然后单击“生成新令牌”。您还可以从该页面访问API文档，并查看之前使用过的所有令牌。
❗ 请注意，一次只能有一个有效的令牌。因此，一旦生成新的令牌，您必须对您已经进行的所有API请求进行更改。
在名为 x-api-key 的标头参数中安装令牌：
可用端点和 URI
所有请求都发送到以下URI：
<https://api3.adsterratools.com/publisher/>
以下是可用的端点列表：
/domains/{format}— 返回您添加到Adsterra的网站，包括它们的名称和唯一ID；/domain/{domain_id}/placements.{format}— 返回指定域名上的广告位；请注意，您首先需要通过/domains/{format}请求获取domain_id；/placements.{format}— 返回您所有广告位的完整列表；/stats.{format}— 根据日期报告展示次数、点击次数、点击率、CPM和收入；您可以指定domain_id、placement_id、起始和结束日期，以及特定的地理位置。
数据可以以JSON、XML和CSV格式检索。请确保在URI中指定您需要的数据格式：
<https://api3.adsterratools.com/publisher/domains.json>
通过API获取Adsterra统计数据的示例请求
我们将通过Postman（一款常用的API测试工具）向您演示一些请求。您可以使用它来了解我们如何格式化数据，并测试您计划进行的请求。
首先，我们需要从以下URI获取我们域名的ID：
<https://api3.adsterratools.com/publisher/domains.json>
在响应正文中，我们可以看到以下内容：
让我们从第一个网站（domain_id为1385226）中找到placement_id：
现在，我们可以使用domain_id和placement_id获取此广告位的统计数据：
响应如下：
可能出现的错误及解决方法
401 — 令牌不正确。请使用您仪表板中的令牌。
403 — 令牌不再有效。请生成新的令牌。
404 — 未找到。请确保URI正确。