---
title: "GET /api/v1/link-gaps"
method: GET
path: "/api/v1/link-gaps"
---

# GET /api/v1/link-gaps

`GET /api/v1/link-gaps`

## Request

- Base URL: `https://12backlinks.com`
- URL: `https://12backlinks.com/api/v1/link-gaps`
- Auth: HTTP bearer

List your latest competitor link exports, created through the API or the website (deleted ones excluded). Free; finished exports are settled on the way. Call get_link_gap for the rows.

## Query parameters

- `limit` integer: Number of exports, newest first. Default 20, maximum 50.

## Response `200`

Success.

- object
  - `link_gaps` object[]
    - `link_gap_id` string
    - `origin` 'keyword' | 'list' | 'bulk'
    - `batch_id` string: Only when origin is bulk: the source batch.
    - `keyword` string, nullable
    - `domain` string, nullable
    - `lang` string, nullable
    - `target` string: Root domain of your site.
    - `status` 'running' | 'done' | 'partial' | 'failed'
    - `running` boolean: false once finished (or stuck for more than 2 hours, then closed).
    - `created_at` string, date-time
    - `source` 'api' | 'ui'
    - `competitors` integer
    - `velocity` boolean
    - `credits_reserved` integer: Maximum reserved at launch.
    - `credits_charged` integer, nullable: Charged on the domains delivered; null until settled (never 0 by default).
    - `credits_refunded` integer, nullable: credits_reserved minus credits_charged, refunded; null until settled.
    - `settled` boolean

## Other responses

- `400`: invalid_request: invalid input.
- `401`: unauthorized: missing, malformed or revoked API key.
- `404`: not_found: missing or not owned by this account.
- `500`: internal_error: unexpected error; retry later, mutations with the same idempotency_key.
- `503`: upstream_unavailable: retry later; mutations with the same idempotency_key.

---

[API](https://skmtc.dev/12backlinks/apis/12backlinks-api.md) · [All operations](https://skmtc.dev/12backlinks/apis/12backlinks-api/llms.txt) · [OpenAPI document](https://skmtc.dev/12backlinks/apis/12backlinks-api/revisions/8936d132d496?raw)