Skip to main content

​
list_brands

List all monitored brands for your account. Use this first to get brand IDs needed for other tools.

​
Parameters

This tool takes no parameters.

​
Returns

FieldTypeDescription
idstringUnique brand identifier
namestringBrand display name
domainstringBrand’s primary domain

​
Example Output

## Your Monitored Brands

1. **Acme Corp** (ID: abc-123-def)
   Domain: acme.com

2. **Acme Pro** (ID: xyz-456-uvw)
   Domain: acmepro.io

​
Example Prompts

What brands am I monitoring?

List my Qwairy brands

Show me my monitored brands

​
OAuth Scope

Requires: read:brands

​
get_overview

Get a quick cockpit overview of a brand: key counts, performance scores with trend vs previous period, and last monitoring date. Use this as the second call after list_brands to get a snapshot before diving into specifics.

​
Parameters

ParameterTypeRequiredDescription
brandIdstringYesThe brand ID from list_brands
periodnumberNoNumber of days to analyze (default: 30)

​
Returns

FieldDescription
countsquestions, answers, competitors, sources, selfMentions, socialCitations, shoppingInsights, localBusinesses
scoresmentionRate, sourceRate, shareOfVoice, sentiment (current period)
previousPeriodScoresSame metrics for previous period (trend comparison)
lastMonitoringDateMost recent AI response date

​
OAuth Scope

Requires: read:brands