> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Source Tools

> Tools to analyze which domains and URLs AI providers cite as sources.

## 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                                            |
| `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

```markdown theme={null}
## Source Domains Cited by AI

| Domain | Type | Mentions | Avg Position | AI Authority | Self | Backlink |
|--------|------|----------|--------------|--------------|------|----------|
| g2.com | COMMERCIAL | 234 | 1.8 | 87.4 | No | Yes |
| acme.com | COMMERCIAL | 198 | 2.3 | 82.1 | Yes | - |
| capterra.com | 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?
```

<Tip>
  Domains with `hasBacklink: true` have known backlink marketplace opportunities. Consider these for outreach.
</Tip>

<Note>
  `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.
</Note>

### 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

```markdown theme={null}
## Source URLs Cited by AI

### 1. g2.com
URL: https://www.g2.com/categories/project-management
Title: Best Project Management Software 2025
Mentions: 89
Avg Position: 1.5

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

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

### 4. acme.com
URL: https://www.acme.com/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?
```

<Note>
  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.
</Note>

### 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`