> ## Documentation Index > Fetch the complete documentation index at: https://docs.markifact.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Backlinks Summary > Get the backlink profile of a domain, subdomain or page from DataForSEO: backlinks, referring domains, IPs and subnets, rank, spam score, broken links, and the TLD, country, link type and platform ... Get the backlink profile of a domain, subdomain or page from DataForSEO: backlinks, referring domains, IPs and subnets, rank, spam score, broken links, and the TLD, country, link type and platform distributions. The competitors report instead lists the domains sharing the most referring domains with the target. Needs the DataForSEO Backlinks subscription. | | | | -------------------- | ---------------------------------- | | **App** | DataForSEO | | **Operation ID** | `dataforseo_get_backlinks_summary` | | **Type** | Action | | **Connection** | `dataforseo` (required) | | **Credits per run** | Free | | **Agent / MCP tool** | Yes | ## Inputs | Field | Type | Required | Default | Description | | ---------------------------- | -------------------------- | -------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `target` | string | Yes | - | Domain, subdomain or page to analyse. Domains go in bare (example.com, blog.example.com); a single page needs its full URL (`https://example.com/pricing`). | | `include_subdomains` | boolean | No | `True` | Count links to subdomains of the target as well. Defaults to true. | | `exclude_internal_backlinks` | boolean | No | `True` | Leave out links coming from the target's own subdomains. Defaults to true. | | `backlinks_status_type` | string or SelectableOption | No | `live` | Which backlinks to count: 'live' (default, found on the last crawl), 'all' (live and lost together) or 'lost' (only links that disappeared). | | `rank_scale` | string or SelectableOption | No | `one_thousand` | Scale for the rank, domain\_from\_rank and page\_from\_rank values: 'one\_thousand' (DataForSEO's default, 0 to 1000) or 'one\_hundred' (0 to 100, comparable to the domain ratings other SEO tools show). | | `report` | string or SelectableOption | No | `profile` | 'profile' (default): one row of backlink profile metrics for the target. 'competitors': the domains that share part of the target's backlink profile, ranked by how many referring domains they have in common with it. | | `include_indirect_links` | boolean | No | `True` | profile only: count links that reach the target through a redirect or a canonical. Defaults to true. | | `backlinks_filters` | array of FilterItem | No | - | profile only: up to 8 filters applied to the backlinks before they are counted, on backlink fields such as dofollow, backlink\_spam\_score, domain\_from\_rank or tld\_from, e.g. dofollow EQUALS true. | | `top_n` | integer | No | `5` | profile only: how many entries to keep in each distribution (top TLDs, countries, link types), 1 to 10. Defaults to 5. | | `main_domain_only` | boolean | No | `True` | competitors only: compare main domains only, ignoring subdomains. Defaults to true, matching DataForSEO; turn it off to let subdomains count as separate competitors. | | `exclude_large_domains` | boolean | No | `True` | competitors only: leave out very large sites such as google.com and amazon.com. Defaults to true. | | `filters` | array of FilterItem | No | - | competitors only: up to 8 filters on target, rank or intersections, e.g. intersections GREATER\_THAN 50. | | `orders` | array of OrderItem | No | - | competitors only: sort by up to 3 of target, rank or intersections. Defaults to intersections descending. | | `limit` | integer | No | `100` | competitors only: maximum number of competitor domains to return (1 to 1000). Defaults to 100. | | `offset` | integer | No | - | competitors only: number of competitors to skip, for paging. | | `fields` | string or array of string | No | - | Result columns to keep, e.g. backlinks, referring\_domains, rank, backlinks\_spam\_score, broken\_backlinks, referring\_links\_types. Leave empty for every column the report returns. | ### FilterItem | Field | Type | Required | Default | Description | | ---------- | -------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `field` | string or SelectableOption | Yes | - | The field to filter on, must be one of the current selected metrics or dimensions. | | `operator` | string | Yes | - | The operator to use for filtering. Must be one of the supported values. Use REGEXP\_MATCH to search/filter by multiple OR values like '.*(summer\|holiday).*' | | `value` | string | Yes | - | The value to filter by, always as a string: text, a number, or a regex. For IN\_LIST and NOT\_IN\_LIST, pass the values as one comma-separated string such as 'a,b,c', not as an array. For regex values, escape backslashes once in the JSON string: write \b for a word boundary, not \b. | ### OrderItem | Field | Type | Required | Default | Description | | ----------- | -------------------------- | -------- | ------- | -------------------------------------------------------------------------------- | | `field` | string or SelectableOption | Yes | - | The field to sort by. must be one of the current selected metrics or dimensions. | | `direction` | string | Yes | - | The order to sort by, must be one of 'ASC', 'DESC' | ### SelectableOption | Field | Type | Required | Default | Description | | ------- | ------ | -------- | ------- | ----------- | | `value` | string | Yes | - | | | `label` | string | Yes | - | | ## Output **Type**: `List[Dict]` profile: a single row with target, rank, backlinks, backlinks\_spam\_score, referring\_domains, referring\_domains\_nofollow, referring\_main\_domains, referring\_pages, referring\_ips, referring\_subnets, broken\_backlinks, broken\_pages, crawled\_pages, internal\_links\_count, external\_links\_count, first\_seen, lost\_date, info (server, cms, platform types, IP, country, target spam score) and the referring\_links\_tld, referring\_links\_types, referring\_links\_attributes, referring\_links\_platform\_types, referring\_links\_semantic\_locations and referring\_links\_countries maps. competitors: one row per domain with target, rank and intersections. **Fields**: `target`, `rank`, `backlinks`, `referring_domains`, `referring_main_domains`, `backlinks_spam_score`, `broken_backlinks` **Example**: ```json theme={"dark"} [ { "target": "ahrefs.com", "rank": 596, "backlinks": 7061158, "referring_domains": 58420, "backlinks_spam_score": 12 } ] ```