# semrush.seo.backlinks.list

Backlinks to a domain or URL with source page and anchor

> This report lists backlinks for a domain, root domain, or URL.

Page: https://telipot.com/catalog/tasks/semrush.seo.backlinks.list · Markdown: https://telipot.com/catalog/tasks/semrush.seo.backlinks.list/md · JSON: https://telipot.com/catalog/tasks/semrush.seo.backlinks.list/json

| Field | Value |
| --- | --- |
| provider | [Semrush](https://telipot.com/catalog/providers/semrush) `semrush` |
| capability | [`seo.backlinks.list`](https://telipot.com/catalog/capabilities/seo.backlinks.list) |
| kind | data |
| tier | core |
| price | Semrush API units (40 API units / result · docs) |
| price note | 40 API units per line returned. Semrush does not charge a request that returns no data. Semrush publishes no USD price per API unit. |
| identity | Your plan |
| auth | `api_key · in query as key` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `GET https://api.semrush.com/analytics/v1/` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://developer.semrush.com/api/v3/seo/backlinks/#backlinks |

## Preview the price · nothing runs

```bash
telipot run semrush.seo.backlinks.list \
  --input-json '{"type":"backlinks","target":"stripe.com","target_type":"root_domain","display_limit":1,"export_columns":"page_ascore,source_url,target_url,anchor,first_seen,last_seen"}' \
  --quote
```

## Run it

```bash
telipot run semrush.seo.backlinks.list \
  --input-json '{"type":"backlinks","target":"stripe.com","target_type":"root_domain","display_limit":1,"export_columns":"page_ascore,source_url,target_url,anchor,first_seen,last_seen"}'
```

```bash
curl https://api.telipot.com/v1/tasks/semrush.seo.backlinks.list/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"backlinks","target":"stripe.com","target_type":"root_domain","display_limit":1,"export_columns":"page_ascore,source_url,target_url,anchor,first_seen,last_seen"}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `type` | queryParams | string | yes | const "backlinks" | Fixed. Selects the Backlinks report. |
| `target` | queryParams | string | yes |  | Root domain, subdomain, or URL of the website to investigate: example.com, www.example.com or http://www.example.com. |
| `target_type` | queryParams | string | yes | one of "root_domain", "domain", "url" | Type of the target. Use domain for a subdomain. |
| `display_limit` | queryParams | integer | yes | 1 to 1000000 | Lines returned, which is what Semrush bills. Semrush returns 10,000 lines when the parameter is omitted or 0, so this task requires it. |
| `display_offset` | queryParams | integer | no | at least 0 | Lines to skip before the report starts. Semrush counts display_limit from the first line, so set display_limit to display_offset plus the lines wanted. |
| `display_sort` | queryParams | string | no | one of "page_ascore_asc", "page_ascore_desc", "last_seen_asc", "last_seen_desc", "first_seen_asc", "first_seen_desc" | Sort rule, one per call. Semrush sorts by page_ascore_desc when it is omitted. |
| `display_filter` | queryParams | string | no |  | Filters on type, zone, ip, refdomain, anchor, newlink, lostlink, urlanchor and redirects, joined with \|. Semrush documents only this form: +\|type\|\|newlink\|+\|type\|\|follow. The urlanchor filter does not work for domains with a large backlink profile. Write it in plain text; the + must reach Semrush as %2B. |
| `export_columns` | queryParams | string | no | default "page_score,source_title,source_url,target_url,anchor,external_num,internal_num,first_seen,last_seen" | Comma-separated column codes, in the order wanted. page_ascore Page Authority Score (page_score is the same), source_url, source_title and source_size of the linking page, target_url and target_title of the page linked to, anchor text, image_url and image_alt for image links, first_seen and last_seen as Unix timestamps, external_num and internal_num links on the source page, response_code, redirect_url, and the flags nofollow, form, frame, image, sitewide, newlink and lostlink. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Fixed. Selects the Backlinks report.",
      "const": "backlinks"
    },
    "target": {
      "type": "string",
      "description": "Root domain, subdomain, or URL of the website to investigate: example.com, www.example.com or http://www.example.com.",
      "examples": [
        "stripe.com"
      ]
    },
    "target_type": {
      "type": "string",
      "description": "Type of the target. Use domain for a subdomain.",
      "enum": [
        "root_domain",
        "domain",
        "url"
      ]
    },
    "display_limit": {
      "type": "integer",
      "description": "Lines returned, which is what Semrush bills. Semrush returns 10,000 lines when the parameter is omitted or 0, so this task requires it.",
      "examples": [
        10
      ],
      "minimum": 1,
      "maximum": 1000000
    },
    "display_offset": {
      "type": "integer",
      "description": "Lines to skip before the report starts. Semrush counts display_limit from the first line, so set display_limit to display_offset plus the lines wanted.",
      "minimum": 0
    },
    "display_sort": {
      "type": "string",
      "description": "Sort rule, one per call. Semrush sorts by page_ascore_desc when it is omitted.",
      "enum": [
        "page_ascore_asc",
        "page_ascore_desc",
        "last_seen_asc",
        "last_seen_desc",
        "first_seen_asc",
        "first_seen_desc"
      ]
    },
    "display_filter": {
      "type": "string",
      "description": "Filters on type, zone, ip, refdomain, anchor, newlink, lostlink, urlanchor and redirects, joined with |. Semrush documents only this form: +|type||newlink|+|type||follow. The urlanchor filter does not work for domains with a large backlink profile. Write it in plain text; the + must reach Semrush as %2B.",
      "examples": [
        "+|type||newlink"
      ]
    },
    "export_columns": {
      "type": "string",
      "description": "Comma-separated column codes, in the order wanted. page_ascore Page Authority Score (page_score is the same), source_url, source_title and source_size of the linking page, target_url and target_title of the page linked to, anchor text, image_url and image_alt for image links, first_seen and last_seen as Unix timestamps, external_num and internal_num links on the source page, response_code, redirect_url, and the flags nofollow, form, frame, image, sitewide, newlink and lostlink.",
      "default": "page_score,source_title,source_url,target_url,anchor,external_num,internal_num,first_seen,last_seen"
    }
  },
  "required": [
    "type",
    "target",
    "target_type",
    "display_limit"
  ],
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "string",
  "pattern": "^(?!\\s*ERROR)",
  "description": "CSV text: a header line of the requested column codes, then one line per backlink, columns separated by semicolons, in the order of export_columns. A body that starts with ERROR is a failure, for example ERROR 50 :: NOTHING FOUND."
}
```