# semrush.seo.backlinks.summary

Backlink counts and Authority Score of a domain or URL

> This report provides a summary of backlinks, including their type, referring domains, and IP addresses for a domain, root domain, or URL.

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

| Field | Value |
| --- | --- |
| provider | [Semrush](https://telipot.com/catalog/providers/semrush) `semrush` |
| capability | [`seo.backlinks.summary`](https://telipot.com/catalog/capabilities/seo.backlinks.summary) |
| kind | data |
| tier | core |
| price | Semrush API units (40 API units / call · docs) |
| price note | 40 API units per request, not per line. 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-overview |

## Preview the price · nothing runs

```bash
telipot run semrush.seo.backlinks.summary \
  --input-json '{"type":"backlinks_overview","target":"stripe.com","target_type":"root_domain","export_columns":"ascore,total,domains_num,follows_num,nofollows_num"}' \
  --quote
```

## Run it

```bash
telipot run semrush.seo.backlinks.summary \
  --input-json '{"type":"backlinks_overview","target":"stripe.com","target_type":"root_domain","export_columns":"ascore,total,domains_num,follows_num,nofollows_num"}'
```

```bash
curl https://api.telipot.com/v1/tasks/semrush.seo.backlinks.summary/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"backlinks_overview","target":"stripe.com","target_type":"root_domain","export_columns":"ascore,total,domains_num,follows_num,nofollows_num"}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `type` | queryParams | string | yes | const "backlinks_overview" | Fixed. Selects the Backlinks overview 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. |
| `export_columns` | queryParams | string | yes |  | Comma-separated column codes, in the order wanted. ascore Authority Score, total backlinks, domains_num referring domains, urls_num referring URLs, ips_num referring IP addresses, ipclassc_num referring class C subnets, follows_num follow backlinks, nofollows_num nofollow backlinks, sponsored_num sponsored backlinks, ugc_num user-generated backlinks, texts_num text backlinks, images_num image backlinks, forms_num backlinks from forms, frames_num backlinks from frames. Semrush's docs list score and trust_score in the default but not among the accepted values, so name the columns you want. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Fixed. Selects the Backlinks overview report.",
      "const": "backlinks_overview"
    },
    "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"
      ]
    },
    "export_columns": {
      "type": "string",
      "description": "Comma-separated column codes, in the order wanted. ascore Authority Score, total backlinks, domains_num referring domains, urls_num referring URLs, ips_num referring IP addresses, ipclassc_num referring class C subnets, follows_num follow backlinks, nofollows_num nofollow backlinks, sponsored_num sponsored backlinks, ugc_num user-generated backlinks, texts_num text backlinks, images_num image backlinks, forms_num backlinks from forms, frames_num backlinks from frames. Semrush's docs list score and trust_score in the default but not among the accepted values, so name the columns you want.",
      "examples": [
        "ascore,total,domains_num,urls_num,ips_num,follows_num,nofollows_num"
      ]
    }
  },
  "required": [
    "type",
    "target",
    "target_type",
    "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 of values, 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."
}
```