{
  "url": "https://telipot.com/catalog/tasks/semrush.seo.backlinks.refdomains",
  "id": "semrush.seo.backlinks.refdomains",
  "name": "Referring domains of a domain or URL with Authority Score",
  "provider": {
    "slug": "semrush",
    "name": "Semrush"
  },
  "capability": "seo.backlinks.refdomains",
  "platform": "seo",
  "kind": "data",
  "tier": "core",
  "identity": "key",
  "identityLabel": "Your plan",
  "price": {
    "native": {
      "text": "40 API units per result",
      "figure": "40 API units",
      "per": "result",
      "currency": "API units"
    },
    "confidence": "documented",
    "source": "docs",
    "sourceUrl": "https://developer.semrush.com/api/v3/seo/backlinks/#referring-domains",
    "checked": "2026-10-05",
    "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.",
    "type": "per_result",
    "state": "native",
    "label": "Semrush API units",
    "detail": "40 API units / result · docs"
  },
  "providers": 1,
  "retention": "standard",
  "runsOn": "byoc",
  "live": true,
  "summary": "This report lists domains pointing to the queried domain, root domain, or URL.",
  "method": "GET",
  "path": "/analytics/v1/",
  "host": "https://api.semrush.com",
  "docsUrl": "https://developer.semrush.com/api/v3/seo/backlinks/#referring-domains",
  "auth": {
    "scheme": "api_key",
    "label": "api_key · in query as key",
    "short": "api_key · ?key"
  },
  "scope": "any_account",
  "principal": "organization",
  "requiredScopes": [],
  "verification": {
    "state": "none",
    "label": "Not verified yet",
    "detail": "Not checked yet. We test with a real request before we mark it."
  },
  "input": [
    {
      "name": "type",
      "location": "queryParams",
      "type": "string",
      "required": true,
      "constraints": [
        "const \"backlinks_refdomains\""
      ],
      "note": "Fixed. Selects the Referring domains report."
    },
    {
      "name": "target",
      "location": "queryParams",
      "type": "string",
      "required": true,
      "constraints": [],
      "note": "Root domain, subdomain, or URL of the website to investigate: example.com, www.example.com or http://www.example.com."
    },
    {
      "name": "target_type",
      "location": "queryParams",
      "type": "string",
      "required": true,
      "constraints": [
        "one of \"root_domain\", \"domain\", \"url\""
      ],
      "note": "Type of the target. Use domain for a subdomain."
    },
    {
      "name": "display_limit",
      "location": "queryParams",
      "type": "integer",
      "required": true,
      "constraints": [
        "at least 1"
      ],
      "note": "Lines returned, which is what Semrush bills. Semrush returns 10,000 lines when the parameter is omitted or 0, so this task requires it."
    },
    {
      "name": "display_offset",
      "location": "queryParams",
      "type": "integer",
      "required": false,
      "constraints": [
        "at least 0"
      ],
      "note": "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."
    },
    {
      "name": "display_sort",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [
        "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\""
      ],
      "note": "Sort rule, one per call. Semrush sorts by backlinks_num_desc when it is omitted."
    },
    {
      "name": "display_filter",
      "location": "queryParams",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "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."
    },
    {
      "name": "export_columns",
      "location": "queryParams",
      "type": "string",
      "required": true,
      "constraints": [],
      "note": "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."
    }
  ],
  "sampleInput": {
    "type": "backlinks_refdomains",
    "target": "stripe.com",
    "target_type": "root_domain",
    "display_limit": 1,
    "export_columns": "domain_ascore,domain,backlinks_num,first_seen,last_seen"
  },
  "inputSchema": {
    "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": [
    {
      "name": "output",
      "type": "string",
      "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."
    }
  ],
  "outputSchema": {
    "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."
  },
  "commands": {
    "mode": "run",
    "cli": "telipot run semrush.seo.backlinks.refdomains \\\n  --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\"}'",
    "http": "curl https://api.telipot.com/v1/tasks/semrush.seo.backlinks.refdomains/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -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\"}'",
    "quote": "telipot run semrush.seo.backlinks.refdomains \\\n  --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\"}' \\\n  --quote"
  },
  "siblings": []
}