SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Turn a mention into a link prospect

POSThttps://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/mentions/{mention_id}/prospect

Recent Requests

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

Path Params

site_idstringrequired
mention_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

target_urlstring

Page on the site the link should point to.

Response

Response Body

idstringProspect id. Use it as prospect_id.
source_urlstringPage you want a link from.
source_domainstringDomain of that page.
contact_namestring | nullWho to ask.
contact_emailstring | nullTheir email.
target_urlstring | nullPage on the site the link should point to.
suggested_anchorstring | nullAnchor text to ask for.
statusstringOutreach state.
sourcestringWhere the prospect came from: added by hand, a brand mention, the API, an import, or a site an AI answer cited.
owner_user_idinteger | nullMember chasing it.
notesstring | nullFree-text notes.
next_follow_up_onstring | nullWhen the next follow-up is due.
last_verified_atstring | nullLast time the page was checked for the link.
verification_statusstring | nullResult of the last check.
backlink_idstring | nullBacklink created once the link went live.
created_atstringCreation time.
updated_atstringLast change.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/mentions/{mention_id}/prospect \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"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": {
"id": "3f2b9c44-8f4e-4d0a-9c1b-2a7d6e5f1a23",
"source_url": "https://partner.example.org/resources",
"source_domain": "partner.example.org",
"contact_name": "Jo Baker",
"contact_email": "jo@partner.example.org",
"target_url": null,
"suggested_anchor": null,
"status": "prospect",
"source": "manual",
"owner_user_id": 12,
"notes": null,
"next_follow_up_on": null,
"last_verified_at": null,
"verification_status": "missing",
"backlink_id": null,
"created_at": "2026-09-01T09:00:00.000Z",
"updated_at": "2026-09-01T09:00:00.000Z"
}
}