那么，您对使用SEMrush项目API感兴趣，但不确定从哪里开始？你来对地方了！
项目API允许您从SEMrush上的站点审计和位置跟踪工具收集原始数据，以您喜欢的任何方式使用。您可以使用此API来分析大数据，并通过轻松集成来增强自己的软件。
我们之前已经发布了一篇关于SEMrush API的博客文章，我们有一个API文档页面，里面有详细的说明。这篇文章旨在指导你如何使用Projects API。
为什么要使用项目API？
通过使用Projects API，您可以跟踪您和您的竞争对手的关键字排名，发现本地竞争对手，从一个位置修复网站的页面问题，等等。
项目API允许用户创建、编辑和管理使用站点审计和位置跟踪工具的项目。API只是用户与SEMrush交互的另一种方式。您可以从现有项目中获取报告，或者使用API创建新项目并在网站上查看它。
为了确保您可以通过API设置自己的项目，我们将从创建新项目到运行活动和提取报告的过程中进行讲解。
如何使用项目API
为了使用SEMrush API，您必须升级您的帐户。我们不再提供包含API单元的订阅。如果您有兴趣了解更多关于我们的API选项，请与我们联系。一旦你找到你的API密钥，你会想要保持这个隐私从其他未经授权的用户使用你的帐户。此密钥对您来说是唯一的，确保您使用该密钥进行的任何调用都需要支付必要的API单元。
此API密钥可以在您的API帐户设置页面中找到。您还可以在此页面上看到您还剩下多少API单元。
您需要估计您的API需求，以选择最合适的API包。否则，当您达到API限制时，我们的请求将被停止。
请求格式
与Analytics API不同，所有Project API请求都使用HTTP方法，如POST、PUT、GET或DELETE。除了GET请求，你不能简单地在浏览器中输入呼叫。虽然在Project API页面中有很多API调用，但它们都属于这四种类型的请求：
POST：你发送一个POST调用来创建一些新的东西，例如创建一个新的项目，启用位置跟踪/站点审计工具。
PUT：当你想对你现有的项目做一些改变，例如改变关键字或竞争对手的位置跟踪，改变抓取的页面限制。
GET：您可以发送一个GET调用来获取当前项目的一些报告，例如每日有机位置报告，获取站点审计活动的问题
DELETE：你可以发送DELETE调用来删除任何存在的东西，例如删除一个存在的项目，从一个存在的项目中删除关键字。
创建一个新项目
无论你是想建立一个位置跟踪还是站点审计项目，你要做的第一件事就是创建一个新项目。这意味着为项目命名，选择一个域，添加关键字和要跟踪的竞争对手，以及用标签对关键字进行分组。
最后三个参数是设置位置跟踪的高级步骤，在本步骤中不需要。如果你只是想建立一个站点审计项目，你可以把这些部分留空。如果你想在将来建立一个位置跟踪项目，不要担心。你也可以添加关键字和竞争对手在未来。
请求URL （POST）如下：
https://api.semrush.com/management/v1/projects?key= {API_key}
启用位置跟踪/站点审计工具
一旦您设置了项目，那么您将需要启用该项目的位置跟踪或站点审计功能。
对于位置跟踪，启用请求解锁了接收项目域及其竞争对手关键字排名的每日更新的可能性。您需要在请求中发布跟踪URL，位置信息，电子邮件通知。
对于站点审计，它允许您安排审计，从抓取中包括或排除页面，并设置要抓取的页面数量。您需要在请求中发布域名、计划抓取日期、页面限制和允许/不允许的页面。
请求URL （POST）如下：
https://api.semrush.com/management/v1/projects/ {ID} /跟踪/启用?关键= {API_key}
https://api.semrush.com/management/v1/projects/{ID}/siteaudit/enable?key={API_key}
运行审计
当我们完成启用工具时，我们能够获得位置跟踪工具的报告。但是，Site Audit工具还有一个步骤：运行审核。只需发送POST请求，不需要任何细节。它将使用快照id进行响应，我们可以使用快照id获得审计报告。
{“snapshot_id”:“54102 d92e4b0f889a040c9c8”}
请求URL （POST）如下：
https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/launch?key={API_key}
收到你的报告
现在，您可以享受来自项目的漂亮数据。您可以收到您的位置跟踪项目的有机报告，AdWords报告和竞争对手发现报告。从您的站点审计项目中，您可以获得单个抓取的问题报告或您的站点审计项目活动的所有时间问题报告。
由于这些API调用都是GET请求，因此只需在浏览器中输入请求url，就会看到组织良好的JSON格式响应，如下所示。
请求URL （GET）如下：
https://api.semrush.com/reports/v1/projects/ {ID} / siteaudit /信息?关键= {API_key}
样品
下面的示例代码在Python 2环境下运行。这四个调用涵盖了从建立新项目到提取Site Audit结果的过程。您可以复制并粘贴示例代码到脚本程序中进行测试。不要忘记在脚本中输入您自己的API_Key。
建立一个新项目
进口的要求
Url = “https://api.semrush.com/management/v1/projects”
querystring = {“key“:“{API_Key}“}
有效载荷= “{\“project_name \”,\“ProjectAPI \”,\“url \”:\“amazon.com \”,\“竞争者\”:[\“google.com \”,\“ebay.com”\],\ \“关键词”:[{\“关键词\”:\“搜索工具\”,\“标签\”:[\“搜索”\]},{\“关键词\”:\“搜索引擎\”,\“标签\”:[\“搜索”\]}]}”
Headers = {
“内容类型”:“application / json”,
cache - control: no - cache”
｝
响应=请求。请求（“POST“, url, data=payload, headers=headers, params=querystring）
打印(response.text)
启用站点审计
url = “https://api.semrush.com/management/v1/projects/{ID}/siteaudit/enable”
querystring = {“key“:“{API_Key}“}
载荷= “ {\ r \ n \ t \“域\”:\“amazon.com \”、\ r \ n \ t \“scheduleDay \”:0,\“通知\”:假的,\“pageLimit \”:1000年,\“userAgentType \”:1,\“设备\”:桌面\ r \ n \ t} \ r \ n \ t \ r \ n”
Headers = {
“内容类型”:“application / json”,
cache - control: no - cache”
｝
响应=请求。请求（“POST“, url, data=payload, headers=headers, params=querystring）
打印(response.text)
运行审计
url = “https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/launch”
querystring = {“key“:“{API_Key}“}
Headers = {
cache - control: no - cache”
｝
响应=请求。请求（“POST“, url, headers=headers, params=querystring）
打印(response.text)
得到报告
url = “https://api.semrush.com/reports/v1/projects/{ID}/siteaudit/info”
querystring = {“key“:“{API_Key}“}
Headers = {
cache - control: no - cache”
｝
响应=请求。请求（“GET“, url, headers=headers, params=querystring）
打印(response.text)
结论
API是一种快速生成信息和获取所需数据的有效方法。为了使用我们的API，您必须升级您的帐户。我们不再提供包含API单元的订阅。如果您有兴趣了解更多关于我们的API选项，请与我们联系。