Backlinks Summary API
curl --request POST \
--url https://api.socq.ai/v1/seo/backlinks-summary \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"target": "<string>",
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/seo/backlinks-summary"
payload = {
"target": "<string>",
"callback_url": "<string>"
}
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({target: '<string>', callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/seo/backlinks-summary', 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/backlinks-summary",
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([
'target' => '<string>',
'callback_url' => '<string>'
]),
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/backlinks-summary"
payload := strings.NewReader("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\"\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/backlinks-summary")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/seo/backlinks-summary")
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 \"target\": \"<string>\",\n \"callback_url\": \"<string>\"\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
Backlinks Summary
Get the backlink profile totals of a domain or page.
POST
/
v1
/
seo
/
backlinks-summary
Backlinks Summary API
curl --request POST \
--url https://api.socq.ai/v1/seo/backlinks-summary \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"target": "<string>",
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/seo/backlinks-summary"
payload = {
"target": "<string>",
"callback_url": "<string>"
}
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({target: '<string>', callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/seo/backlinks-summary', 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/backlinks-summary",
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([
'target' => '<string>',
'callback_url' => '<string>'
]),
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/backlinks-summary"
payload := strings.NewReader("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\"\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/backlinks-summary")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/seo/backlinks-summary")
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 \"target\": \"<string>\",\n \"callback_url\": \"<string>\"\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": {}
}
}Backlinks Summary
Get the shape of a site’s link profile in one row: authority rank, total backlinks, referring domains and root domains, referring IPs and subnets, nofollow share, broken links, spam score and the date links were first seen. Breakdowns show which top-level domains and countries the links come from, which link types and rel attributes dominate, and where on the page links sit. It is the quick read you want before a deeper backlink audit, for a prospect’s site, a competitor or your own domain.{
"target": "notion.so"
}
Standard Result Fields
Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, usefields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | Yes | The analyzed target, used as the identifier. |
platform | string | No | Platform the result belongs to, such as instagram or linkedin. |
resource | string | No | SocQ resource represented by the result, such as videos or comments. |
type | string | No | Category of the result item, such as video, post, or comment. |
url | string | Yes | Homepage URL of the target, or the page URL when a page was analyzed. |
published_at | string | Yes | Time the source item was published, in ISO 8601 format when available. |
collected_at | string | No | Time SocQ collected or processed this result, in ISO 8601 format. |
target | string | Yes | Domain, subdomain or page that was analyzed. |
rank | integer | Yes | Authority score from 0 to 1000 based on the link profile; higher is stronger. |
backlinks_count | integer | Yes | Number of live backlinks pointing to the target. |
referring_domains_count | integer | Yes | Number of domains linking to the target. |
referring_main_domains_count | integer | Yes | Number of root domains linking to the target, counting subdomains once. |
referring_pages_count | integer | Yes | Number of pages linking to the target. |
referring_ips_count | integer | Yes | Number of IP addresses hosting the linking domains. |
referring_subnets_count | integer | Yes | Number of subnets hosting the linking domains. |
nofollow_referring_domains_count | integer | Yes | Number of linking domains whose links are all nofollow. |
nofollow_referring_pages_count | integer | Yes | Number of linking pages whose links are nofollow. |
broken_backlinks_count | integer | Yes | Number of backlinks pointing to pages on the target that no longer load. |
broken_pages_count | integer | Yes | Number of pages on the target that receive links but no longer load. |
crawled_pages_count | integer | Yes | Number of pages crawled on the target. |
spam_score | integer | Yes | Spam score from 0 to 100; higher means more signs of spam. |
first_seen_at | string | Yes | Time the first backlink to the target was found, in ISO 8601 format. |
referring_tlds | array<object> | Yes | Top-level domains of the linking sites, largest first. |
referring_tlds.name | string | Yes | Top-level domain, such as com. |
referring_tlds.count | integer | Yes | Number of backlinks in this group. |
referring_countries | array<object> | Yes | Countries of the linking sites, largest first. |
referring_countries.name | string | Yes | Two-letter country code; empty when unknown. |
referring_countries.count | integer | Yes | Number of backlinks in this group. |
link_types | array<object> | Yes | Kinds of links pointing to the target, largest first. |
link_types.name | string | Yes | Link kind, such as anchor, image or redirect. |
link_types.count | integer | Yes | Number of backlinks in this group. |
link_attributes | array<object> | Yes | rel attributes found on the links, largest first. |
link_attributes.name | string | Yes | rel attribute, such as nofollow or sponsored. |
link_attributes.count | integer | Yes | Number of backlinks in this group. |
platform_types | array<object> | Yes | Kinds of sites the links come from, largest first. |
platform_types.name | string | Yes | Site kind, such as blogs, news or ecommerce. |
platform_types.count | integer | Yes | Number of backlinks in this group. |
semantic_locations | array<object> | Yes | Parts of the linking pages where the links sit, largest first. |
semantic_locations.name | string | Yes | Page section, such as article, nav or footer; empty when unknown. |
semantic_locations.count | integer | Yes | Number of backlinks in this group. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-seo-backlinks-summary",
"status": "succeeded",
"public_id": "seo/backlinks-summary",
"result_count": 1,
"credits_amount": 10,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "backlink-summary",
"schema_version": "1.0",
"items": [
{
"id": "notion.so",
"platform": "seo",
"resource": "backlinks-summary",
"type": "backlink-summary",
"url": "https://notion.so",
"published_at": null,
"collected_at": "2026-11-17T14:43:17.043730Z",
"target": "notion.so",
"rank": 634,
"backlinks_count": 10052197,
"referring_domains_count": 128955,
"referring_main_domains_count": 110833,
"referring_pages_count": 8441052,
"referring_ips_count": 56804,
"referring_subnets_count": 26776,
"nofollow_referring_domains_count": 20463,
"nofollow_referring_pages_count": 988513,
"broken_backlinks_count": 1523327,
"broken_pages_count": 59408,
"crawled_pages_count": 292556,
"spam_score": 6,
"first_seen_at": "2019-01-15T23:01:18Z",
"referring_tlds": [
{
"name": "com",
"count": 4264250
},
{
"name": "ai",
"count": 757560
},
{
"name": "me",
"count": 580658
},
{
"name": "io",
"count": 418450
},
{
"name": "fm",
"count": 332609
}
],
"referring_countries": [
{
"name": null,
"count": 1636733
},
{
"name": "US",
"count": 963284
},
{
"name": "KR",
"count": 768685
},
{
"name": "AI",
"count": 758317
},
{
"name": "JP",
"count": 757299
}
],
"link_types": [
{
"name": "anchor",
"count": 8271627
},
{
"name": "image",
"count": 154183
},
{
"name": "redirect",
"count": 14476
},
{
"name": "canonical",
"count": 758
},
{
"name": "alternate",
"count": 8
}
],
"link_attributes": [
{
"name": "noopener",
"count": 2870776
},
{
"name": "noreferrer",
"count": 2844737
},
{
"name": "nofollow",
"count": 988041
},
{
"name": "external",
"count": 78186
},
{
"name": "ugc",
"count": 48080
}
],
"platform_types": [
{
"name": "unknown",
"count": 4345396
},
{
"name": "organization",
"count": 2886490
},
{
"name": "ecommerce",
"count": 874414
},
{
"name": "blogs",
"count": 568199
},
{
"name": "cms",
"count": 550189
}
],
"semantic_locations": [
{
"name": "footer",
"count": 2917529
},
{
"name": null,
"count": 2484346
},
{
"name": "section",
"count": 1343288
},
{
"name": "nav",
"count": 904026
},
{
"name": "article",
"count": 375205
}
]
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json
Provide a domain, subdomain or page URL in target. Subdomains are included when target is a domain. The result is one row with the link profile totals.
Domain, subdomain or page URL, such as example.com or https://example.com/blog/.
Minimum string length:
1
