Skip to main content
POST
/
create-query-group
cURL
curl --request POST \
  --url https://api.mindshare.so/customer/v1/create-query-group \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "customerID": 123,
  "name": "<string>",
  "websiteUrl": "<string>",
  "keywords": "<string>",
  "language": "<string>",
  "countryCode": "<string>"
}
'
{
  "data": {
    "query_group_id": 123
  },
  "version": "<string>",
  "env": "<string>"
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json

Query Group details

​
customerID
number
required

The ID of the customer to create the Query Group for. Must be a valid, existing customer that belongs to the caller's organization.

​
name
string
required

Display name for the Query Group (e.g., "SASE", "Network Security"). Must be non-empty.

​
websiteUrl
string
required

The website URL associated with this Query Group. Does not require http(s):// prefix — bare domains like mindshare.so are valid.

​
keywords
string
required

Comma-separated list of SEO high-intent keywords to track (e.g., "residential proxies, rotating proxies, static proxies"). Each keyword must be non-empty after trimming.

​
language
string
required

The language for the keywords (case-insensitive). Supported languages: English, Portuguese, Spanish, German, French, Italian, Dutch, Swedish, Polish, Norwegian, Danish, Finnish, Greek, Hungarian, Czech, Romanian, Ukrainian, Slovak, Bulgarian, Croatian, Serbian, Slovenian, Lithuanian, Latvian, Estonian, Icelandic, Belarusian, Bosnian, Albanian, Macedonian, Georgian, Armenian, Azerbaijani, Hindi, Japanese, Korean, Indonesian, Urdu, Bengali, Filipino, Vietnamese, Thai, Burmese, Chinese, Malay, Uzbek, Kazakh, Turkmen, Tajik, Kyrgyz, Sinhala, Khmer, Lao, Hebrew, Arabic, Turkish, Swahili

​
countryCode
string
required

Two-letter country code indicating the location context for running queries (e.g., "us", "gb", "il"). Supported codes: us, ca, br, mx, ar, co, cl, pe, ve, ec, bo, uy, pa, cr, do, jm, de, gb, fr, it, es, nl, ch, se, pl, be, at, no, dk, ie, fi, pt, gr, hu, cz, ro, ua, lu, sk, bg, hr, rs, si, lt, lv, ee, is, by, md, ba, al, mk, cy, ge, am, az, im, li, in, jp, kr, id, pk, bd, ph, vn, th, mm, tw, my, hk, sg, uz, kz, tm, tj, kg, lk, kh, la, mo, bn, il, ae, sa, za, ng, eg, tr, iq, qa, kw, om, jo, ma, ke, gh, tz, cm, tn, zw, bw, mz, mw, zm, sl, cg, au, nz

Response

200 - application/json

Query Group created successfully

​
data
object
required

Created Query Group details

​
version
string
required

API version

​
env
string
required

Environment name