SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Import the rows from a previewed CSV

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

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

rowsarray of array of stringssrequired

Rows from the preview.

mappingarray of stringsrequired

Field per column from the preview.

sourcestringrequired

gsc_csv or bing_csv.

filenamestring

Original file name, for the import history.

default_target_urlstring

Page on this site that every row links to, when no column names one.

Response

Response Body

importobjectThe import record.
addedintegerNew links.
updatedintegerLinks already known and refreshed.
rejectedintegerRows skipped.
reject_reasonsarray of objectsWhy rows were skipped.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/links/import \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"rows": [
[
"https://partner.example.org/review"
]
],
"mapping": [
"source_url"
],
"source": "gsc_csv",
"filename": "links.csv",
"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 · 201

{
"data": {
"import": {},
"added": 200,
"updated": 31,
"rejected": 9,
"reject_reasons": [
{}
]
}
}