流量估算
curl --request POST \
--url https://api.socq.ai/v1/seo/traffic-estimate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"targets": [
"<string>"
],
"callback_url": "<string>",
"language_code": "en",
"location_code": 2840
}
'import requests
url = "https://api.socq.ai/v1/seo/traffic-estimate"
payload = {
"targets": ["<string>"],
"callback_url": "<string>",
"language_code": "en",
"location_code": 2840
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
targets: ['<string>'],
callback_url: '<string>',
language_code: 'en',
location_code: 2840
})
};
fetch('https://api.socq.ai/v1/seo/traffic-estimate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/seo/traffic-estimate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'targets' => [
'<string>'
],
'callback_url' => '<string>',
'language_code' => 'en',
'location_code' => 2840
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/seo/traffic-estimate"
payload := strings.NewReader("{\n \"targets\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/seo/traffic-estimate")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"targets\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/seo/traffic-estimate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"targets\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}SEO
流量估算
一次估算最多 1000 个域名的 Google 搜索流量。
POST
/
v1
/
seo
/
traffic-estimate
流量估算
curl --request POST \
--url https://api.socq.ai/v1/seo/traffic-estimate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"targets": [
"<string>"
],
"callback_url": "<string>",
"language_code": "en",
"location_code": 2840
}
'import requests
url = "https://api.socq.ai/v1/seo/traffic-estimate"
payload = {
"targets": ["<string>"],
"callback_url": "<string>",
"language_code": "en",
"location_code": 2840
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
targets: ['<string>'],
callback_url: '<string>',
language_code: 'en',
location_code: 2840
})
};
fetch('https://api.socq.ai/v1/seo/traffic-estimate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/seo/traffic-estimate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'targets' => [
'<string>'
],
'callback_url' => '<string>',
'language_code' => 'en',
'location_code' => 2840
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/seo/traffic-estimate"
payload := strings.NewReader("{\n \"targets\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/seo/traffic-estimate")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"targets\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/seo/traffic-estimate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"targets\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}流量估算
一次调用估算一批网站的搜索流量。最多传入 1000 个域名,每个域名返回来自自然搜索的预估月访问量和有排名的关键词数,以及付费搜索对应的两项数据。可以用来按体量给潜在客户或合作方排序、补充 CRM 数据,或者一次性对比整个品类的竞争对手。{
"targets": [
"notion.so",
"figma.com",
"canva.com"
],
"location_code": 2840,
"language_code": "en"
}
标准结果字段
任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式,但不会推断或补充来源未提供的数据。如需缩小返回字段集合,MCP 查询使用fields,Typed 工具使用 _result_fields,CLI 使用 --result-fields。声明字段的值为 null 时仍会保留。
| 字段 | 类型 | 可空 | 说明 |
|---|---|---|---|
id | string | 是 | 被估算的域名,作为标识。 |
platform | string | 否 | 结果所属的平台,例如 instagram 或 linkedin。 |
resource | string | 否 | 该结果对应的 SocQ 资源,例如 videos 或 comments。 |
type | string | 否 | 结果项的类别,例如 video、post 或 comment。 |
url | string | 是 | 该域名的首页地址。 |
published_at | string | 是 | 源内容的发布时间(如可获得),使用 ISO 8601 格式。 |
collected_at | string | 否 | SocQ 采集或处理该结果的时间,使用 ISO 8601 格式。 |
domain | string | 是 | 被估算的域名。 |
organic_traffic | number | 是 | 来自自然搜索结果的预估月访问量。 |
organic_keywords_count | integer | 是 | 该域名有自然排名的关键词数量。 |
paid_traffic | number | 是 | 来自付费搜索广告的预估月访问量。 |
paid_keywords_count | integer | 是 | 该域名在搜索广告中投放的关键词数量。 |
任务完成响应
{
"code": 200,
"data": {
"task_id": "example-seo-traffic-estimate",
"status": "succeeded",
"public_id": "seo/traffic-estimate",
"result_count": 3,
"credits_amount": 3.3,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "traffic-estimate",
"schema_version": "1.0",
"items": [
{
"id": "figma.com",
"platform": "seo",
"resource": "traffic-estimate",
"type": "traffic-estimate",
"url": "https://figma.com",
"published_at": null,
"collected_at": "2026-11-17T15:30:19.383645Z",
"domain": "figma.com",
"organic_traffic": 1026703.1318624247,
"organic_keywords_count": 167848,
"paid_traffic": 38.05037307739258,
"paid_keywords_count": 2
},
{
"id": "notion.so",
"platform": "seo",
"resource": "traffic-estimate",
"type": "traffic-estimate",
"url": "https://notion.so",
"published_at": null,
"collected_at": "2026-11-17T15:30:19.384480Z",
"domain": "notion.so",
"organic_traffic": 13302.66677077845,
"organic_keywords_count": 399,
"paid_traffic": 0.0,
"paid_keywords_count": 0
},
{
"id": "canva.com",
"platform": "seo",
"resource": "traffic-estimate",
"type": "traffic-estimate",
"url": "https://canva.com",
"published_at": null,
"collected_at": "2026-11-17T15:30:19.384621Z",
"domain": "canva.com",
"organic_traffic": 22780312.5278251,
"organic_keywords_count": 666024,
"paid_traffic": 0.0,
"paid_keywords_count": 0
}
]
}
}
}
请求体
application/json
通过 targets 提供最多 1000 个域名。选择支持的国家,以及该国家可用的语言;默认美国(2840)和英语(en)。每个域名返回一行。每次请求计 3 积分,每个域名再加 0.1 积分。
语言代码或语言筛选条件。
可用选项:
Albanian, Arabic, Armenian, Azeri, Bengali, Bosnian, Bulgarian, Chinese (Simplified), Chinese (Traditional), Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, German, Greek, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Latvian, Lithuanian, Macedonian, Malay, Norwegian (Bokmål), Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovenian, Spanish, Swedish, Tagalog, Thai, Turkish, Ukrainian, Urdu, Vietnamese Minimum string length:
1国家代码,填写本接口支持的国家;与 location_name 二选一。
可用选项:
2008, 2012, 2024, 2031, 2032, 2036, 2040, 2048, 2050, 2051, 2056, 2068, 2070, 2076, 2100, 2104, 2116, 2120, 2124, 2144, 2152, 2158, 2170, 2188, 2191, 2196, 2203, 2208, 2218, 2222, 2233, 2246, 2250, 2276, 2288, 2300, 2320, 2344, 2348, 2356, 2360, 2372, 2376, 2380, 2384, 2392, 2398, 2400, 2404, 2410, 2428, 2440, 2458, 2470, 2484, 2492, 2498, 2504, 2528, 2554, 2558, 2566, 2578, 2586, 2591, 2600, 2604, 2608, 2616, 2620, 2642, 2682, 2686, 2688, 2702, 2703, 2704, 2705, 2710, 2724, 2752, 2756, 2764, 2784, 2788, 2792, 2804, 2807, 2818, 2826, 2840, 2854, 2858, 2862 必填范围:
x >= 1国家名称,填写本接口支持的国家;与 location_code 二选一。
可用选项:
Albania, Algeria, Angola, Argentina, Armenia, Australia, Austria, Azerbaijan, Bahrain, Bangladesh, Belgium, Bolivia, Bosnia and Herzegovina, Brazil, Bulgaria, Burkina Faso, Cambodia, Cameroon, Canada, Chile, Colombia, Costa Rica, Cote d'Ivoire, Croatia, Cyprus, Czechia, Denmark, Ecuador, Egypt, El Salvador, Estonia, Finland, France, Germany, Ghana, Greece, Guatemala, Hong Kong, Hungary, India, Indonesia, Ireland, Israel, Italy, Japan, Jordan, Kazakhstan, Kenya, Latvia, Lithuania, Malaysia, Malta, Mexico, Moldova, Monaco, Morocco, Myanmar (Burma), Netherlands, New Zealand, Nicaragua, Nigeria, North Macedonia, Norway, Pakistan, Panama, Paraguay, Peru, Philippines, Poland, Portugal, Romania, Saudi Arabia, Senegal, Serbia, Singapore, Slovakia, Slovenia, South Africa, South Korea, Spain, Sri Lanka, Sweden, Switzerland, Taiwan, Thailand, Tunisia, Turkiye, Ukraine, United Arab Emirates, United Kingdom, United States, Uruguay, Venezuela, Vietnam Minimum string length:
1
