OneClickSEO.ai
Developer API

Backlink gap

Runs a backlink-gap analysis comparing your domain against a set of competitors and surfaces link prospects - domains that link to competitors but not to you. The run is an asynchronous job; fetch the resulting prospects with Gap prospects.

Create a gap run

POST/backlinks/gap
Body parameters
ParameterTypeDescription
domainrequiredstringYour domain.
competitorsrequiredstring[]Competitor domains to compare against (1-20).
modestring`union` (link to ANY competitor) or `intersect` (link to ALL competitors). Defaults to `union`.
limitintegerMaximum prospects to return, 10-1000. Defaults to `100`.
cURL
curl -X POST "https://api.oneclickseo.ai/v1/backlinks/gap" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "mysite.com", "competitors": ["a.com", "b.com"], "mode": "union" }'
202Run accepted
Response
{
  "data": {
    "id": "run_4d2a90",
    "status": "running",
    "mode": "union",
    "competitor_count": 2
  },
  "meta": { "request_id": "req_8f2c1a", "credits_charged": 7 }
}

Fetch run status

GET/backlinks/gap/{run_id}
200Completed run
Response
{
  "data": {
    "id": "run_4d2a90",
    "status": "completed",
    "prospect_count": 184,
    "credits_charged": 7,
    "finished_at": "2026-06-15T08:02:00Z"
  },
  "meta": { "request_id": "req_8f2c1a" }
}
Credit cost is dynamic

A gap run's cost scales with the number of competitors and the result `limit` (minimum 1 credit). The exact amount is returned in `meta.credits_charged` when the run is created.

Related