Skip to main content
POST
/
create-query-group-from-existing
cURL
curl --request POST \
  --url https://api.mindshare.so/customer/v1/create-query-group-from-existing \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "customerID": 123,
  "name": "<string>",
  "parentQueryGroupId": 123,
  "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

Clone 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 new Query Group. Must be a non-empty string.

parentQueryGroupId
number
required

The ID of the existing Query Group to clone from. Must belong to the same customer, exist, and not be deleted.

websiteUrl
string

Override the website URL. If not provided, inherited from the parent Query Group.

keywords
string

Override the keywords. Comma-separated list of SEO high-intent keywords (e.g., "residential proxies, rotating proxies"). If keywords differ from the parent's, the system generates new queries from scratch rather than cloning existing ones. If not provided, inherited from the parent Query Group.

language
string

Override the language (case-insensitive). If not provided, inherited from the parent Query Group. 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

Override the two-letter country code for execution location (e.g., "us", "gb", "il"). If not provided, inherited from the parent Query Group. 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