---
title: "List internal link suggestions"
method: GET
path: "/v3/site-linking/suggestions"
tags: ["Internal Linking"]
---

# List internal link suggestions

`GET /v3/site-linking/suggestions`

## Request

- Base URL: `https://api.snowseo.com`
- URL: `https://api.snowseo.com/v3/site-linking/suggestions`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

The internal links the analysis suggests adding, best first. Each has the page to add the link on (`sourceUrl`), the page it should point to (`targetUrl`), the exact words on the source page to turn into the link (`anchorText`) with the sentence around them, a confidence from 0 to 1, why it was suggested, and its status: pending, approved, rejected or applied. `counts` gives the total in each status for the brand. Filter by status, by one page, by a folder or by topic group. Use this to answer 'what internal links should I add' or 'which pages should link to X'. Read-only.

## Query parameters

- `teamId` string, required
- `status` 'pending' | 'approved' | 'rejected' | 'applied'
- `minConfidence` number
- `search` string
- `clusterIds` string
- `pageUrl` string
- `sourcePrefix` string
- `sortBy` 'source' | 'linkText' | 'target' | 'why' | 'confidence' | 'status'
- `sortDir` 'asc' | 'desc'
- `page` integer
- `pageSize` string

## Response `200`

Default Response

## Changes

- **2026-10-12** `09cbe0d8a50f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/site-linking/suggestions/get.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) - [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/snowseo/apis/snowseo-api/revisions/ac69ae8943d7?raw)