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

# List Source Domains

> Monitor which domains AI platforms cite

Track which websites AI platforms cite when answering questions about your industry. Identify opportunities to get your content cited, and monitor which sources influence AI responses in your space.

<Note>
  See [Entities](/developers/entities#source) for the complete Source object structure.
</Note>

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer qw-api-xxx`
</ParamField>

### Path Parameters

<ParamField path="brandId" type="string" required>
  The unique identifier of the brand
</ParamField>

### Query Parameters

<ParamField query="period" type="number">
  Number of days to include. If not specified, returns all data.
</ParamField>

<ParamField query="startDate" type="string">
  Start date (ISO 8601 format)
</ParamField>

<ParamField query="endDate" type="string">
  End date (ISO 8601 format)
</ParamField>

<ParamField query="provider" type="string">
  Filter by AI provider. Supports comma-separated multi-select (e.g., `chatgpt,claude`).
</ParamField>

<ParamField query="type" type="string">
  Filter by source type: `INSTITUTIONAL`, `COMMERCIAL`, `MEDIA`, `BLOG`, etc.
</ParamField>

<ParamField query="topic" type="string">
  Filter by topic ID. Supports comma-separated multi-select (e.g., `id1,id2`).
</ParamField>

<ParamField query="tag" type="string">
  Filter by tag ID. Supports comma-separated multi-select (e.g., `id1,id2`).
</ParamField>

<ParamField query="limit" type="number" default="50">
  Maximum number of sources to return (max: 100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of results to skip for pagination
</ParamField>

<ParamField query="sort" type="string" default="mentions">
  Field to sort by: `mentions`, `position`, `rate`, `domain`
</ParamField>

<ParamField query="order" type="string" default="desc">
  Sort order: `asc` or `desc`
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful
</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="Pagination info">
    <ResponseField name="total" type="number">Total number of sources matching filters</ResponseField>
    <ResponseField name="count" type="number">Number of sources in this response</ResponseField>
    <ResponseField name="limit" type="number">Maximum items per page</ResponseField>
    <ResponseField name="offset" type="number">Number of items skipped</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="sources" type="array">
  <Expandable title="Source object">
    <ResponseField name="id" type="string">Source ID</ResponseField>
    <ResponseField name="domain" type="string">Domain name</ResponseField>
    <ResponseField name="type" type="string">Source type</ResponseField>
    <ResponseField name="isSelf" type="boolean">Whether this is your own domain</ResponseField>
    <ResponseField name="totalMentions" type="number">Total citation count</ResponseField>
    <ResponseField name="rate" type="number">Share of Citations (%) - percentage of all citations from this source</ResponseField>
    <ResponseField name="avgPosition" type="number">Average position in source lists</ResponseField>
  </Expandable>
</ResponseField>

### Example Request

```bash theme={null}
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/source-domains?limit=10&offset=0" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

### Example Response

```json theme={null}
{
  "success": true,
  "pagination": {
    "total": 45,
    "count": 2,
    "limit": 10,
    "offset": 0
  },
  "sources": [
    {
      "id": "src1",
      "domain": "industry-news.com",
      "type": "MEDIA",
      "isSelf": false,
      "totalMentions": 102,
      "rate": 5.10,
      "avgPosition": 3.2
    },
    {
      "id": "src2",
      "domain": "mybrand.com",
      "type": "INSTITUTIONAL",
      "isSelf": true,
      "totalMentions": 45,
      "rate": 2.25,
      "avgPosition": 2.1
    }
  ]
}
```