Record a backlink you know about.

source_url must be on another domain and target_url on this site. 402 quota_exceeded means the plan cap is reached.

POSThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/links

Recent Requests

TimeStatusUser Agent

Make a request to see history.

Path Params

site_idstringrequired

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

source_urlstring

Page that links to the site.

target_urlstring

Page on the site it links to.

anchor_textstring

Link text if known.

notesstring

Free-text notes.

Response

Response Body

idstringBacklink id. Use it as link_id.

source_urlstringPage that links to the site.

source_domainstringDomain of the linking page.

target_urlstringPage on the site being linked to.

anchor_textstring | nullLink text.

is_followedboolean | nullNull until verified.

placementstring | nullcontent, nav, footer or sidebar once verified.

statusstringlive, lost, broken, unknown or pending.

discovery_sourcesarray of stringsWhere the link was learned from.

disavowedbooleanIncluded in the disavow file.

notesstring | nullFree-text notes.

first_seen_atstring | nullFirst time the link was known.

last_checked_atstring | nullLast time the page was opened to verify it.

lost_atstring | nullWhen the link stopped being found.

Request

import { SoftSolz } from '@softsolz/sdk';

const client = new SoftSolz({ apiKey: process.env.SOFTSOLZ_API_KEY });

const result = await client.seo.createSiteLink('<site_id>', {});
console.log(result);

Credentials

Authorization

Sent as a Bearer token. Stored only in your browser.

Response · 201

{
  "data": {
    "id": "string",
    "source_url": "string",
    "source_domain": "string",
    "target_url": "string",
    "anchor_text": "string",
    "is_followed": true,
    "placement": "string",
    "status": "string",
    "discovery_sources": [],
    "disavowed": true,
    "notes": "string",
    "first_seen_at": "string",
    "last_checked_at": "string",
    "lost_at": "string"
  }
}