Search the web for pages mentioning the brand phrases and verify each one.

A web search plus a fetch of each candidate page; SoftSolz keeps only pages where the phrase is really present. 400 no_brand_phrases means set brand_phrases in the link settings first. Spends no AI credits.

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

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.

Response

Response Body

phrasesarray of stringsPhrases searched.

candidatesintegerPages the search returned.

verifiedintegerPages where the phrase was confirmed.

discardedintegerPages that did not hold up.

addedintegerNew mentions stored.

updatedintegerMentions already known.

Request

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

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

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

Credentials

Authorization

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

Response · 200

{
  "data": {
    "phrases": [],
    "candidates": 0,
    "verified": 0,
    "discarded": 0,
    "added": 0,
    "updated": 0
  }
}