import_backlinks

Remaining arguments go in a JSON object body. Supply idempotencyKey as the Idempotency-Key header on this resource route.

post/v1/discovery/imports

Request

  • Base URL: https://app.agentlinkops.com
  • URL: https://app.agentlinkops.com/v1/discovery/imports
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Headers

Idempotency-Keystring

Caller-generated key reused only for retries of the same operation and arguments in this workspace.

X-Workspace-IDstring

Required when using a Clerk human session. With an API key, omit this header or supply its bound workspace.

Request body

projectIdstring required

project ID from create/list.

supplier'ahrefs' | 'google_search_console' | 'bing_webmaster_tools' | 'semrush' | 'majestic' | 'moz' | 'dataforseo' | 'linkody' | 'csv' required

Source of imported candidate evidence, retained as provenance.

targetKind'domain' | 'exact_url' required

Whether target identifies an exact URL or a domain.

targetstring required

Exact URL or domain to query, interpreted according to targetKind.

includeSubdomainsboolean required

Include subdomains of the selected domain in this query.

backlinksStatus'live' | 'lost' | 'all' required

Supplier-reported backlink status filter; this is not AgentLinkOps verification.

supplierGeneratedAtstring date-time nullable

Supplier export generation timestamp, distinct from import time.

Response

Remaining arguments go in a JSON object body. Supply idempotencyKey as the Idempotency-Key header on this resource route.

v1 required
idstring required

Resource identifier returned by the operation.

workspace_idstring required

Workspace that owns this record.

project_idstring required

Project that owns this record.

provider'linktrail_corpus' | 'dataforseo' | 'imported' required
data_mode'synthetic' | 'owned_corpus' | 'provider_index' | 'imported' required
status'queued' | 'running' | 'succeeded' | 'partial' | 'failed' | 'reconciliation_required' required

Resource lifecycle status.

created_atstring date-time required

UTC timestamp when the record was created.

started_atstring date-time nullable required
finished_atstring date-time nullable required
coverage'pending' | 'complete_for_query' | 'capped' | 'partial' | 'unknown' required

Dataset scope and completeness, including limits on what these results establish.

coverage_reasonstring nullable required
provider_total_countinteger nullable required
operation'backlinks' required
coverage_scope'customer_import' | 'corpus_subset' | 'provider_query' required
whole_web_coveragefalse required

False: these results do not measure the whole web.

replayedboolean

True when the response reuses an earlier request with the same idempotency value.

rejected_totalnumber required
duplicates_totalnumber required

Changes

No recorded changes to this operation across all 1 revision of this API.