Competitors
List a brand's competitors of one relation, filtered and paged.
apiKeyx-api-key<token>Workspace API key from Settings > API keys. Also accepted as Authorization: Bearer gsk_...
brandId*stringuuidrelation?stringdirect: tracked competitor; ignored: hidden and left out of analytics; suggested: found in AI answers, not reviewed yet
"direct""ignored""suggested"q?stringMatches name or domain
length <= 100tagIds?stringComma-separated tag ids; matches competitors with any of them
length <= 2000page?integer1 <= value1pageSize?integer1 <= value <= 10025One page of competitors
application/jsonitems*array<>total*integerpage*integerpageSize*integercurl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/competitors'{ "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "website": "string", "domain": "string", "logoUrl": "string", "aliases": [ "string" ], "domainAliases": [ "string" ], "includeSubdomains": true, "relation": "direct", "source": "ai", "tags": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string" } ] } ], "total": 0, "page": 0, "pageSize": 0}curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/competitors'{
"items": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"website": "string",
"domain": "string",
"logoUrl": "string",
"aliases": [
"string"
],
"domainAliases": [
"string"
],
"includeSubdomains": true,
"relation": "direct",
"source": "ai",
"tags": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string"
}
]
}
],
"total": 0,
"page": 0,
"pageSize": 0
}