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, mapping and default_target_url to POST /links/import to commit. Files with no column for the page on this site, such as the Search Console export for one linking site, need default_target_url.
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/links/import/previewRecent Requests
Kept only in this browserPath Params
site_idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Idempotency-KeystringOptional idempotency key for safe retries.
Body Params
csv_textstringrequiredThe CSV file content.
mappingarray of stringsOptional field per column, in order, to override the suggested mapping: source_url, target_url, anchor, first_seen or ignore.
default_target_urlstringPage on this site that every row links to, used when no column names one. Must be on this site.
Response
Response Body
headersarray of stringsColumn headers found.suggested_mappingarray of stringsField per column, in order.row_countintegerRows parsed.truncatedbooleanThe file had more rows than max_rows; only the first max_rows were read.max_rowsintegerMost rows one import reads.needs_targetbooleanNo column names the page on this site, so every row needs a target page.homepage_urlstringThis site home page, the usual target for such a file.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
curl --request POST \ --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/links/import/preview \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "csv_text": "Linking page,Last crawled\n...", "mapping": [ "source_url" ], "default_target_url": "https://acmebakery.co.uk/"}'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 200
{ "data": { "headers": [ "Linking page" ], "suggested_mapping": [ "source_url" ], "row_count": 240, "truncated": false, "max_rows": 20000, "needs_target": false, "homepage_url": "https://acmebakery.co.uk/", "rows": [ [ "https://partner.example.org/review" ] ], "would_accept": 231, "would_reject": 9, "reject_reasons": [ {} ] }}