SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

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.

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

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

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_textstringrequired

The CSV file content.

mappingarray of strings

Optional field per column, in order, to override the suggested mapping: source_url, target_url, anchor, first_seen or ignore.

default_target_urlstring

Page 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": [
{}
]
}
}