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.
POST
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/mentions/findRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path 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.
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
curl --request POST \ --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/mentions/find \ --header 'Authorization: Bearer sk_live_your_key'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": { "phrases": [ "Acme Bakery" ], "candidates": 18, "verified": 7, "discarded": 11, "added": 5, "updated": 2 }}