> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Why do backlinks show one link per website, and how do I get more?

> POST /v1/seo/backlinks defaults to one_per_domain: true to return one link per referring site; set one_per_domain to false and paginate with limit and offset to list multiple links per domain.

`POST /v1/seo/backlinks` returns one link per referring website by default because `one_per_domain` defaults to `true`. Set `one_per_domain` to `false` and adjust `limit` and `offset` to retrieve multiple linking pages from the same domain.

## Request multiple links per domain

Backlink endpoints accept `domain`, `one_per_domain`, `limit` (`1–1000`, default `100`), and `offset` (`0–10000`, default `0`). Do not send `country` or `language`: backlink tools have no market dimension and reject both fields with `400 bad_request`.

```bash
curl -sS https://api.beatapi.io/v1/seo/backlinks \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"domain":"example.com","one_per_domain":false,"limit":25,"offset":0}'
```

Increment `offset` by `limit` to fetch subsequent pages. Every returned row adds to `billed_rows` (`$0.035` per call plus `$0.0002` per returned row), so size `limit` to the rows needed.

## Verify returned links

Each row in `results` reports `source_url`, `source_domain`, `anchor`, `target_url`, `dofollow`, `first_seen`, `last_seen`, `is_lost`, and `is_broken`. When two articles from the same publication link to a maintenance guide, keep both `source_url` entries along with each link's `anchor` and `target_url`. Open `source_url` directly to confirm a link is still live on the current page.

## Contracts and related questions

Before sending a paid request, inspect the SEO contracts for free: `data:seo.keyword_overview`, `data:seo.ranked_keywords`, `data:seo.top_pages`, `data:seo.backlinks`.

[Back to SEO questions](/faq/seo).