# semrush.seo.backlinks.refdomains

Referring domains of a domain or URL with Authority Score

> This report lists domains pointing to the queried domain, root domain, or URL.

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

| Field | Value |
| --- | --- |
| provider | [Semrush](https://telipot.com/catalog/providers/semrush) `semrush` |
| capability | [`seo.backlinks.refdomains`](https://telipot.com/catalog/capabilities/seo.backlinks.refdomains) |
| 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/#referring-domains |

## Preview the price · nothing runs

```bash
telipot run semrush.seo.backlinks.refdomains \
  --input-json '{"type":"backlinks_refdomains","target":"stripe.com","target_type":"root_domain","display_limit":1,"export_columns":"domain_ascore,domain,backlinks_num,first_seen,last_seen"}' \
  --quote
```

## Run it

```bash
telipot run semrush.seo.backlinks.refdomains \
  --input-json '{"type":"backlinks_refdomains","target":"stripe.com","target_type":"root_domain","display_limit":1,"export_columns":"domain_ascore,domain,backlinks_num,first_seen,last_seen"}'
```

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

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `type` | queryParams | string | yes | const "backlinks_refdomains" | Fixed. Selects the Referring domains 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 | at least 1 | 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 "domain_ascore_asc", "domain_ascore_desc", "backlinks_num_asc", "backlinks_num_desc", "last_seen_asc", "last_seen_desc", "first_seen_asc", "first_seen_desc" | Sort rule, one per call. Semrush sorts by backlinks_num_desc when it is omitted. |
| `display_filter` | queryParams | string | no |  | Filters on zone, country, ip, newdomain, lostdomain and category, joined with \|. Semrush gives no example for this report. Write it in plain text; the + must reach Semrush as %2B. |
| `export_columns` | queryParams | string | yes |  | Comma-separated column codes, in the order wanted. domain_ascore Domain Authority Score (domain_score is the same), domain, backlinks_num backlinks from the domain, domain_trust_score, ip, country, first_seen and last_seen as Unix timestamps. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Fixed. Selects the Referring domains report.",
      "const": "backlinks_refdomains"
    },
    "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
    },
    "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 backlinks_num_desc when it is omitted.",
      "enum": [
        "domain_ascore_asc",
        "domain_ascore_desc",
        "backlinks_num_asc",
        "backlinks_num_desc",
        "last_seen_asc",
        "last_seen_desc",
        "first_seen_asc",
        "first_seen_desc"
      ]
    },
    "display_filter": {
      "type": "string",
      "description": "Filters on zone, country, ip, newdomain, lostdomain and category, joined with |. Semrush gives no example for this report. Write it in plain text; the + must reach Semrush as %2B."
    },
    "export_columns": {
      "type": "string",
      "description": "Comma-separated column codes, in the order wanted. domain_ascore Domain Authority Score (domain_score is the same), domain, backlinks_num backlinks from the domain, domain_trust_score, ip, country, first_seen and last_seen as Unix timestamps.",
      "examples": [
        "domain_ascore,domain,backlinks_num,first_seen,last_seen"
      ]
    }
  },
  "required": [
    "type",
    "target",
    "target_type",
    "display_limit",
    "export_columns"
  ],
  "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 referring domain, 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."
}
```