Backlinks API
curl --request POST \
--url https://api.socq.ai/v1/seo/backlinks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"target": "<string>",
"callback_url": "<string>",
"results_limit": 100
}
'import requests
url = "https://api.socq.ai/v1/seo/backlinks"
payload = {
"target": "<string>",
"callback_url": "<string>",
"results_limit": 100
}
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>', results_limit: 100})
};
fetch('https://api.socq.ai/v1/seo/backlinks', 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",
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>',
'results_limit' => 100
]),
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"
payload := strings.NewReader("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\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")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/seo/backlinks")
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 \"results_limit\": 100\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
Get the backlinks pointing to a domain or page.
POST
/
v1
/
seo
/
backlinks
Backlinks API
curl --request POST \
--url https://api.socq.ai/v1/seo/backlinks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"target": "<string>",
"callback_url": "<string>",
"results_limit": 100
}
'import requests
url = "https://api.socq.ai/v1/seo/backlinks"
payload = {
"target": "<string>",
"callback_url": "<string>",
"results_limit": 100
}
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>', results_limit: 100})
};
fetch('https://api.socq.ai/v1/seo/backlinks', 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",
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>',
'results_limit' => 100
]),
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"
payload := strings.NewReader("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\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")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"results_limit\": 100\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/seo/backlinks")
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 \"results_limit\": 100\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
List the individual links pointing to a site or page, strongest first. Each backlink gives the linking page and its title, the page linked to, anchor text, link type, dofollow status and rel attributes, authority scores for the link, page and domain, spam score, where the link sits on the page, and when it was first and last seen. Use it to audit your own link profile, reverse-engineer a competitor’s best links, or find pages worth asking for a link.{
"target": "notion.so",
"results_limit": 100
}
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 | Identifier of the link, derived from the linking page, the linked page and the anchor. |
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 | URL of the page that contains the link. |
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. |
source_url | string | Yes | URL of the page that contains the link. |
source_domain | string | Yes | Domain of the page that contains the link. |
source_title | string | Yes | Title of the page that contains the link. |
target_url | string | Yes | URL the link points to. |
anchor | string | Yes | Anchor text of the link. |
link_type | string | Yes | Kind of link, such as anchor, image, redirect or canonical. |
is_dofollow | boolean | Yes | Whether the link is a dofollow link that passes ranking value. |
attributes | array<string> | Yes | rel attributes on the link, such as nofollow or ugc. |
rank | integer | Yes | Authority score of the link from 0 to 1000. |
source_page_rank | integer | Yes | Authority score of the linking page from 0 to 1000. |
source_domain_rank | integer | Yes | Authority score of the linking domain from 0 to 1000. |
spam_score | integer | Yes | Spam score from 0 to 100; higher means more signs of spam. |
semantic_location | string | Yes | Part of the page where the link sits, such as article, nav or footer. |
language | string | Yes | Language code of the linking page. |
is_new | boolean | Yes | Whether the link was found since the previous crawl. |
is_lost | boolean | Yes | Whether the link has disappeared from the linking page. |
is_broken | boolean | Yes | Whether the linked page no longer loads. |
first_seen_at | string | Yes | Time the link was first found, in ISO 8601 format. |
last_seen_at | string | Yes | Time the link was last confirmed, in ISO 8601 format. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-seo-backlinks",
"status": "succeeded",
"public_id": "seo/backlinks",
"result_count": 1,
"credits_amount": 10.02,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "backlink",
"schema_version": "1.0",
"items": [
{
"id": "36af82e3018f12d6387d",
"platform": "seo",
"resource": "backlinks",
"type": "backlink",
"url": "https://corporate.sarah30.com/",
"published_at": null,
"collected_at": "2026-11-17T14:43:18.061725Z",
"source_url": "https://corporate.sarah30.com/",
"source_domain": "corporate.sarah30.com",
"source_title": "SARAH inc.",
"target_url": "https://www.notion.so/SARAH-97caa9e30b1941cfbacc35558d1af86a",
"anchor": "採用情報",
"link_type": "anchor",
"is_dofollow": true,
"attributes": [
"noopener",
"noreferrer"
],
"rank": 649,
"source_page_rank": 684,
"source_domain_rank": 518,
"spam_score": 40,
"semantic_location": "nav",
"language": null,
"is_new": false,
"is_lost": false,
"is_broken": false,
"first_seen_at": "2021-03-08T21:58:57Z",
"last_seen_at": "2026-10-24T12:45:53Z"
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json
Provide a domain, subdomain or page URL in target. results_limit defaults to 100 and accepts integers from 1 to 1000. Strongest links come first.
Domain, subdomain or page URL, such as example.com or https://example.com/blog/.
Minimum string length:
1
