DocumentationAPI reference
Backlinks
A site’s backlinks, and refreshing them.
Every operation below is also an MCP tool, under the same name. Free operations cost nothing; Billed ones use the workspace’s credits, as in the app (What it costs).
| Operation | Call | |
|---|---|---|
| Get backlinks | GET /sites/{siteId}/backlinks | Free |
| Refresh backlinks | POST /sites/{siteId}/backlinks | Billed |
Get backlinks
/sites/{siteId}/backlinksFreeThe site’s stored backlink profile: its numbers, top referring domains, anchors and backlinks, the comparison with its top competitors and the link-gap opportunities. null until a first refresh.
- stale is true once the profile is more than 7 days old: refresh_backlinks updates it.
- probable_spam: the referring domains that look like spam (link farms, throwaway domains, casinos, no authority passed), kept out of referring_domains and never in opportunities.
MCP tool get_backlinks
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/backlinks \
-H "Authorization: Bearer sk_live_…"Answers 200 with { "data": … }.
Refresh backlinks
/sites/{siteId}/backlinksBilledFetch the site’s backlink profile again (the site and its top 3 competitors), store it and answer it.
- Billed per data call, exactly as the app’s Refresh: about 10 calls.
- 402 INSUFFICIENT_TOKENS when the credits can’t cover the refresh’s most expensive case, 409 CONFLICT while one runs for the site.
MCP tool refresh_backlinks
| Argument | Type | Description |
|---|---|---|
siteIdin the path | string | Its id. |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/backlinks \
-H "Authorization: Bearer sk_live_…"Answers 200 with { "data": … }.
A question this doesn’t answer? Write to us.

