Source tools

See Filter Compatibility for the authoritative filter contract and the coverage of every MCP tool.

get_source_domains

Get domains that AI cites as sources, ranked by mention frequency.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID
`domain`	string	No	Search by partial domain name
`type`	string	No	Filter by source type (see below)
`isSelf`	boolean	No	Filter to only your domain (`true`) or others (`false`)
`limit`	number	No	Max domains (default: 50)

Source types

Type	Description
`INSTITUTIONAL`	Government, org sites (.gov, .org)
`COMMERCIAL`	Business/product sites
`MEDIA`	News and media outlets
`BLOG`	Blog content
`FORUM`	Forums and communities (Reddit, Quora)
`SOCIAL`	Social media platforms
`EDUCATIONAL`	Educational institutions (.edu)
`OTHER`	Uncategorized

Returns

Field	Type	Description
`id`	string	Source domain ID
`domain`	string	The domain name
`name`	string	Display name (if known)
`type`	string	Source type
`mentions`	number	Total citation count
`avgPosition`	number	Average position in source lists
`aiSourceAuthorityScore`	number	Qwairy Source Authority score (0-100), or `null` when unavailable
`isSelf`	boolean	Whether this is your domain
`hasBacklink`	boolean	Whether backlink opportunity exists

Example output

## Source domains cited by AI

| Domain | Type | Mentions | Avg Position | AI Authority | Self | Backlink |
|--------|------|----------|--------------|--------------|------|----------|
| reviews.example | COMMERCIAL | 234 | 1.8 | 87.4 | No | Yes |
| acme.example | COMMERCIAL | 198 | 2.3 | 82.1 | Yes | - |
| software-guide.example | COMMERCIAL | 156 | 2.5 | 78.6 | No | No |
| techcrunch.com | MEDIA | 89 | 3.1 | 72.3 | No | No |
| reddit.com | FORUM | 67 | 4.2 | 68.9 | No | No |
| wikipedia.org | INSTITUTIONAL | 45 | 2.8 | 74.5 | No | No |

Example prompts

Which sources do AI providers cite most often?

Is my domain being cited as a source?

Show me media sources only

What forums are being cited for my topics?

Domains with hasBacklink: true have known backlink marketplace opportunities. Consider these for outreach.

aiSourceAuthorityScore is Qwairy’s proprietary score based only on how AI providers cite a domain across monitored prompts. It does not use backlinks or external SEO authority metrics.

OAuth scope

Requires: read:sources

get_source_urls

Get specific URLs that AI cites as sources, with citation frequency.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID
`domain`	string	No	Filter by specific domain
`limit`	number	No	Max URLs (default: 50)

Returns

Field	Type	Description
`url`	string	The full URL
`title`	string	Page title (if available)
`domain`	string	The domain
`mentions`	number	Number of times cited
`avgPosition`	number	Average position in source lists

Example output

## Source URLs cited by AI

### 1. reviews.example
URL: https://reviews.example/project-management
Title: Best Project Management Software 2025
Mentions: 89
Avg Position: 1.5

### 2. acme.example
URL: https://www.acme.example/features
Title: Acme Corp Features
Mentions: 72
Avg Position: 2.1

### 3. software-guide.example
URL: https://software-guide.example/project-management
Title: Project Management Software Reviews
Mentions: 56
Avg Position: 2.3

### 4. acme.example
URL: https://www.acme.example/blog/productivity-guide
Title: The Ultimate Productivity Guide
Mentions: 34
Avg Position: 3.4

Example prompts

What specific pages are AI providers citing?

Which of my pages get cited most?

Show me URLs from wikipedia.org that are being cited

What Reddit threads are being cited?

Use the domain filter to drill down into a specific source. For example, filter by your own domain to see which of your pages AI trusts most.

OAuth scope

Requires: read:sources

get_source_trends

Track which source domains are gaining or losing citations in AI answers. The tool compares the selected period with the immediately preceding period of the same length, returns a daily or weekly timeline for the leading sources, and shows the current source-type mix.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID from `list_brands`
`period`	integer or string	No	Global evidence window; defaults to 30 days
`groupBy`	string	No	Timeline granularity: `day` or `week` (default: `day`)
`provider`	string	No	Filter by normalized AI provider
`topicId`	string	No	Filter by topic ID from `list_topics`
`tagId`	string	No	Filter by tag ID from `list_tags`
`limit`	number	No	Max source domains in the timeline (default: 5, max: 10)

Returns

Field	Description
`summary`	Total citations and distinct source domains in the selected period
`sources[]`	Leading domains with source type, current citations, previous-period citations, and percentage change
`timeline[]`	Daily or weekly citations and average citation position for each leading source
`sourceTypes[]`	Citation count and share for each source type

When a source has citations in the selected period but none in the previous period, changePercent is null rather than an invented growth percentage.

Example prompts

Which sources are gaining or losing citations this month?

Show weekly source trends for ChatGPT only

How has the source-type mix changed around this topic?

OAuth scope

Requires: read:sources

get_backlink_opportunities

Prioritized backlink and outreach targets: cited domains where competitors appear but your brand does not, ranked by opportunity, with marketplace pricing and domain rating when available. Use it to plan link-building and digital-PR outreach.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID from `list_brands`
`limit`	number	No	Max opportunities to return

Returns

Field	Description
`summary`	`total`, `veryHigh`, `high` opportunity counts
`opportunities[]`	Per domain: `domain`, `name`, `type`, `mentions`, `brandCitedAnswers`, `competitorCitedAnswers`, `distinctCompetitors`, `priority` (`very-high`/`high`/`medium`/`low`), `bestPrice`, `domainRating`, `platforms[]`

Example prompts

What are my best backlink opportunities right now?

Which high-authority domains cite competitors but not me?

OAuth scope

Requires: read:sources

Get started

Tool reference

Examples

Workflows

get_source_domains

Parameters

Source types

Returns

Example output

Example prompts

OAuth scope

get_source_urls

Parameters

Returns

Example output

Example prompts

OAuth scope

get_source_trends

Parameters

Returns

Example prompts

OAuth scope

get_backlink_opportunities

Parameters

Returns

Example prompts

OAuth scope

​get_source_domains

​Parameters

​Source types

​Returns

​Example output

​Example prompts

​OAuth scope

​get_source_urls

​Parameters

​Returns

​Example output

​Example prompts

​OAuth scope

​get_source_trends

​Parameters

​Returns

​Example prompts

​OAuth scope

​get_backlink_opportunities

​Parameters

​Returns

​Example prompts

​OAuth scope

get_source_domains

Parameters

Source types

Returns

Example output

Example prompts

OAuth scope

get_source_urls

Parameters

Returns

Example output

Example prompts

OAuth scope

get_source_trends

Parameters

Returns

Example prompts

OAuth scope

get_backlink_opportunities

Parameters

Returns

Example prompts

OAuth scope