Correct what a search is really asking for
Intent is worked out by rule from the wording; intent_rule R6 means the wording gave no clear signal and the intent is a best guess. Override it when the rule is wrong for your market; the override sticks, is recorded as manual, and is kept by every later rebuild. Topics pick it up the next time they are rebuilt. Intent drives the intent_mismatch finding, which flags a buying search landing on an article.
https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/queries/{query_id}/intentRecent Requests
Kept only in this browserPath Params
site_idstringrequiredquery_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.
Body Params
intentstringrequiredWhat the person is trying to do.
Response
Response Body
queryobjectThe updated search.Request
curl --request PUT \ --url https://app.softsolz.uk/api/v1/services/seo/sites/{site_id}/queries/{query_id}/intent \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "intent": "transactional"}'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": { "query": { "id": 812, "query_text": "payroll software pricing", "intent": "transactional", "intent_rule": "manual" } }}