Parse a Search Console or Bing links CSV and preview the mapping.

Send the CSV text. The response suggests a column mapping and shows which rows would be accepted; pass rows and mapping to POST /links/import to commit.

POSThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/links/import/preview

Recent Requests

TimeStatusUser Agent

Make a request to see history.

Path Params

site_idstringrequired

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

csv_textstring

The CSV file content.

Response

Response Body

headersarray of stringsColumn headers found.

suggested_mappingarray of stringsField per column, in order.

row_countintegerRows parsed.

rowsarray of array of stringssParsed rows to send back on import.

would_acceptintegerRows that look like links to this site.

would_rejectintegerRows that would be skipped.

reject_reasonsarray of objectsWhy rows would be skipped.

Request

import { SoftSolz } from '@softsolz/sdk';

const client = new SoftSolz({ apiKey: process.env.SOFTSOLZ_API_KEY });

const result = await client.seo.previewLinkImport('<site_id>', {});
console.log(result);

Credentials

Authorization

Sent as a Bearer token. Stored only in your browser.

Response · 200

{
  "data": {
    "headers": [],
    "suggested_mapping": [],
    "row_count": 0,
    "rows": [],
    "would_accept": 0,
    "would_reject": 0,
    "reject_reasons": []
  }
}