Link Gap

DataForSEO

Find domains that link to competitors but not to the promoted site.

Capability: Link opportunity research
Current price: $0.0336/call
Availability: Ready to run

What this API does

Intersects two to twenty competitor link profiles and can exclude up to ten owned domains, producing a bounded prospect list for link acquisition.

Agents select this operation with tool ID dataforseo.link-gap, then inspect its current executable contract before a run.

Public input and output shape

Input

backlinks_status_typestring · optional

Value supplied for backlinks status type.

enum: all, live, lost

exclude_targetsarray · optional

Value supplied for exclude targets.

maxItems: 10

include_subdomainsboolean · optional

Value supplied for include subdomains.

intersection_modestring · optional

Value supplied for intersection mode.

enum: all, partial

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 1000

offsetinteger · optional

Value supplied for offset.

minimum: 0 · maximum: 100000000

rank_scalestring · optional

Value supplied for rank scale.

enum: one_hundred, one_thousand

targetsarray · required

Value supplied for targets.

minItems: 2 · maxItems: 20

Output

itemsarray

Returned items value.

items_countnumber

Returned items count value.

total_countnumber

Returned total count value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "dataforseo.link-gap",
  "input": {
    "limit": 1,
    "targets": [
      "ahrefs.com",
      "semrush.com"
    ],
    "exclude_targets": [
      "dataforseo.com"
    ]
  }
}

Output

{
  "items": [
    {
      "summary": {
        "intersections_count": 2
      },
      "domain_intersection": {
        "1": {
          "rank": 58,
          "target": "plumbersandhvacmarketers.com",
          "backlinks": 13717
        },
        "2": {
          "rank": 42,
          "target": "plumbersandhvacmarketers.com",
          "backlinks": 793
        }
      }
    }
  ],
  "items_count": 1,
  "total_count": 13160
}

Teaching errors and limitations

configuration_error: DataForSEO account access, funding or cost controls blocked the request.Verify and fund the server-side DataForSEO API-access credentials, then retry unchanged.
invalid_input: DataForSEO rejected a target, location or bounded result control.example: {"targets":["ahrefs.com","semrush.com"],"exclude_targets":["dataforseo.com"],"limit":1}

Use Link Gap with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.