💡 如果您正在摆脱电子表格或已经拥有适当的分析系统，您可以使用我们的API自动获取所需的数据，而无需每隔一段时间导入CSV文件。
💡 请注意，我们的API仅支持GET方法。这意味着您无法使用API删除或添加域名或广告格式。
获取API令牌
每位用户的访问速率上限为每分钟 1200 次请求，每份 API 返回结果缓存时长 60 秒。
如需获取 API 令牌，请在左侧菜单栏打开 “设置”（API 标签页）页面，点击生成新令牌：
❗️ 请注意，令牌仅可在生成时查看、复制，生成完毕后无法再次查看。
在 API 页面，您还可以看到：
当前有效令牌数量 —— 账号最多同时持有 5 个有效 API 令牌；
可点击跳转的 API 文档链接；
全部有效令牌的相关信息，包含：
名称
状态
到期日期（单枚令牌有效期 1 年）
创建日期
上次使用的日期与时间
IP 地址
国家
重命名或删除每个单独令牌的选项：
令牌即将到期时，您会收到邮件提醒。
在名为 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正确。