---
title: "Backlinks and link exchanges"
description: "Vet a site that offers a link, record the deal, let Writavo confirm both links and keep the history, and choose which links are dofollow, nofollow or sponsored."
canonical: "https://writavo.com/docs/links"
last-updated: "2026-09-30"
---

# Backlinks and link exchanges

Keep every link swap, guest post or paid placement in one place. You say who the deal is with; Writavo checks both links and keeps the history.

## Nothing about a link is typed in

- **Your side** is read from your published articles within a few minutes of adding or removing the link.
- **Their side** is read from their page at once, then weekly. With no page named, Writavo watches your backlinks for a link from their site.
- **The history** (recorded, agreed, first seen, turned nofollow, disappeared) is kept by the database and cannot be edited.
- Free: no credits, no plan requirement, no approval step for an assistant.

## From the offer to the record

1. **Check the offer.** `inspectLinkProspect` with their page. Reports whether it loads, is `noindex`, links to very many sites (a sign of a link list), already links to you (followed or not), is linked from your articles, or is on your disavow list. Stores nothing.
2. **Record the deal.** `createLinkExchange` with `their_page_url` (or just `partner_domain`). Optional: `kind` (`swap`, `guest_post`, `paid`, `other`), `contact`, `note`, `our_target_url` (your page they should link to), `status`.
3. **Add your link.** Use `update_article`; the exchange finds it. Mark a swapped or paid link (see below).
4. **Confirm theirs.** `checkLinkExchange` reads their page now: is the link there, is it followed, what does it say. Open exchanges are also re-read weekly.
5. **Find deals that need attention.** `listLinkExchanges` with `needs_attention=true`. `getLinkExchange` returns one deal with its full `history`.

Dashboard: **SEO, Link Exchanges** (check a page, **Add exchange**, **Check now**, history behind the clock icon).

## One verdict per deal

Each exchange has one `health` value, the same everywhere.

| `health` | What it means | Needs attention |
|---|---|---|
| `balanced` | Both links live; theirs is followed. | no |
| `their_link_removed` | Theirs was seen and is gone; yours is live. | yes |
| `their_link_nofollow` | Theirs is nofollow, sponsored or ugc; yours is live. | yes |
| `waiting_on_them` | Yours is live; theirs never seen. | yes |
| `waiting_on_us` | Theirs is live; none of your published articles link to them. | no |
| `not_started` | Neither link exists yet. | no |
| `could_not_check` | Their page did not load. Nothing concluded; re-read next week. | no |
| `closed` | You declined or ended the deal. | no |

> An unreadable page never counts as a removed link. Only a page read without your link, or a 404 or 410, does.

## Dofollow, nofollow and sponsored

One rule sets a link's `rel`, on the blog Writavo serves and in the API's `content_html`:

1. **What is set on the link wins.** `setArticleLinkRel` with the article and the link's `target_url` (from `listArticleLinks`). `rel` is `follow`, `nofollow`, `sponsored`, `ugc`, or `null` to clear. Dashboard: the **Ranking credit** menu in SEO, Internal Links, All links, or beside the editor's Link button.
2. **Otherwise, a link to your own pages is followed.** As a path or a full address on your domain.
3. **Otherwise, a link to another site takes the Site setting.** `external_link_rel` on `updateSiteSettings`: `follow` (default) or `nofollow`. Dashboard: Settings, Site, Links to other sites.

A per-link choice is stored in the link's Markdown title (stripped on render), so it survives the editor, the API, export and import:

```markdown
[our partner](https://partner.example/page "rel:sponsored")
```

- Writing that title in `create_article` or `update_article` equals calling `setArticleLinkRel`.
- Rendering Markdown `content` yourself? Read `rel:follow`, `rel:nofollow`, `rel:sponsored` or `rel:ugc` from the title and set the link's `rel`.
- Search engines ask that paid or exchanged links carry `sponsored` or `nofollow`. That choice is yours; each exchange shows whether your link is followed (`our_link.followed`).
- A WordPress import keeps links marked nofollow, sponsored or ugc.

## Every link in your articles

Read from your articles within minutes of a publish, edit or import.

| You want | Operation |
|---|---|
| Every link, with its state and whether it is followed | `listArticleLinks` (filter by `type`, `state`, `article_id`, `target_article_id`, `domain`, `q`) |
| Problems: orphans, under-linked articles, broken links, anchor text | `getInternalLinkReport` |
| Sites you link to, and which link back | `listOutboundLinkDomains` (add `reciprocal=true`) |
| Every link to one site | `listOutboundLinks` |
| Who links to you | `getBacklinkOverview`, `listBacklinks` (import with `importBacklinksCsv` or `syncBing`) |

## What it does not do

- **No site scores.** Authority, spam score and traffic need a paid link index; `inspectLinkProspect` lists them in `not_measured`.
- **No email.** Contacting partners is up to you. Outreach campaigns are set up by a person in the dashboard; an assistant can only read their status.
- **No changes to anyone's link.** Removing an exchange stops tracking; your article keeps its link until you edit it.
