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

# Sources

> Every site and page AI engines cite, whoever owns it.

AI engines build answers from pages they find on the web. The **Sources** page lists every site and page they cite in answers to your prompts: independent sites, your competitors' sites and your own. [Content](/concepts/content) shows topics and your page for each. The full page inventory is on [Website](/concepts/site-readability).

Under the title, one sentence sums up the period: how many citations went to how many pages on how many sites, how many other sites mention you, and what share of citations went to your own pages. When AI cites none of your own pages, it says so: "AI cites none of your own pages." A share under one percent reads "Under 1% of citations are your own pages."

**Names you** counts only pages Heralded read that named your brand. Sites with and without `www`, or a port in their address, count as one site. Ownership follows your confirmed domains and the competitors you track today. It also counts a discovered competitor's site as competitor-owned when at least three answers in the selected period name that brand. Discovery includes every weekly report in the period and excludes channel platforms. This ownership stays the same when you filter citations by engine or prompt. Your own domains take precedence; other source types follow each scan's recorded classification.

## Filters

The filter bar carries the same filters as the other pages: **Period**, **Engine**, **Type**, **Intent** and **Topic**, and **Segment** when you have more than one. Sources adds four of its own:

* **Owner**: **Third-party**, **Competitor** or **Yours**.
* **Source type**: the kind of site, such as review platforms, press and media or **Software vendors**. **Independent sites** holds the sites Heralded could not place in another type. Your site and your competitors' sites are **Corporate**.
* **Names you**: **Yes** or **No**. Your own sites are left out of both.
* **Prompt**: one of your tracked prompts.

Everything on the page follows the filters: the sentence, the cards, the chart and both tables. To find the sites worth pitching, start with **Worth pursuing**.

Opening **All sources cited for this topic** from [Content](/concepts/content#the-topic-pane) narrows both **Sites** and **Pages** to that Content topic. Its name appears above the table. **Clear topic** removes this filter and keeps your other filters.

## Cards

* **Citations** counts citations in the period.
* **Sites cited** counts the sites cited.
* **Your pages** is your own pages' share of all citations. It appears once AI cites one of them, and shows a share under one percent as under 1%.
* **Competitors' pages** is your competitors' pages' share of all citations. A rise shows in red.

Citations compare the average per report in the period with the preceding baseline. Sites cited compares the count of sites. The two share cards compare citations paired by prompt and engine across the period and its baseline, and read **Steady** when the paired test cannot tell the change from noise. Until there is an earlier report to compare with, no card shows a trend and one line says **Trends start after your first weekly report**.

## Citation mix

One bar shows where the citations go, by kind of source. Each citation uses the source type recorded in its report, so a site can contribute to more than one segment across reports. Your site and your competitors' sites each have their own segment, and the legend gives each share.

## Worth pursuing

Above **Sites**, **Worth pursuing** shows up to three sites you can pitch, under the line **Busy sites AI cites that don't mention you yet**. They are ranked by the search demand of the prompts citing each site, weighted by the site's authority, among sites that don't name you. Open a card's title for the site's pane. **Start** files a pitch if needed, then asks you to confirm before the Publicist drafts an email for your review. **Not now** dismisses the pitch, filing it first if needed, so you can restore it from **Actions** → **Dismissed**. **All** opens the table with **Owner** set to **Third-party** and **Names you** set to **No**, in Heralded's order. The cards hide when no actionable sites remain and on **Pages**.

## Sites and Pages

The table has two tabs. **Search sources** narrows the rows in either tab, and it pages ten rows at a time.

**Sites** lists each cited site with its source type, and marks your competitors' sites and your own. **You** says whether the site names you. **Citations** gives the count and its share of all citations. **Cited in** is the share of answers that cite the site. **Trend** shows an arrow and the change in citations per report when the move against the baseline is real, judged by the paired test over every answer by prompt and engine. Otherwise it reads **Steady**, and it is empty when the period has no comparable baseline. The table starts in Heralded's order: the sites worth pursuing first. Click a column head to sort by it, again to reverse, and a third time to return to Heralded's order. **Back to Heralded's order** also resets the sort. Opening a site opens its pane.

**Pages** lists each cited page with its site and content type. **Topic** names the topic the page is cited for and your status on that topic from Content. On a competitor's page, the topic opens that topic on Content. **Citations** and **Prompts** count the page's citations and the prompts whose answers cite it. Your own page opens its page pane. A competitor's page opens its pane from [Competitors](/concepts/competitors#a-competitors-pane). A page on an independent site opens its own cited-page pane.

## A source's pane

A site's pane shows its source type and owner below the read-only scope in the header. The link beside the title opens the site in a new tab. The pane follows the period, engine, type, intent, topic, segment and prompt filters, and the Content topic when opened from that topic's sources. Owner, source type and names-you narrow the page's list and do not change the pane.

**Add an action** is the primary action at the bottom-right. **Mute this source** and the partner controls are in the **⋯** menu at the bottom-left. Removing a partner mark asks you to confirm first. On a muted source, **Unmute this source** is the primary action. A message confirms the change or explains a failure. Muting and partner changes offer **Undo**. The close control is at the top-right, and the header stays visible as you scroll.

* **Citations**, **Cited in** and **Names you** sum the site up. **Cited in** reads like "17% of answers".
* A bar chart gives its citations by weekly report.
* **Names most** ranks your brand and tracked competitors by how many of the site's cited pages name them. Each row shows the page count and share of pages Heralded read on the site. It lists the top five, plus your brand even at zero, marked **You**. Opening a competitor's row opens its pane, with a back control to return. If no page was read, it says "Heralded hasn't read a page on this site yet."
* **Pages** lists its five most cited pages. Each opens that page's pane. **All cited pages from** the site opens the Pages tab narrowed to that site, until you clear it.
* **Prompts** lists the prompts whose answers cite it most. Each opens the prompt's pane.
* **Engines** gives one card per engine that cites it, with the share of that engine's answers that cite it.
* **Actions** lists the outreach and correction work tied to the site. If you can start work, **Add an action** files a pitch for an independent site that has none. **Mark as partner** records that its company is your partner, and when Heralded suggests one you can **Confirm partner** or answer **Not a partner**. **Mute this source** stops suggestions and news about the site. Its citations still count, and you can unmute it.
* The closing link opens the answers that cite the site under the same filters.

## An independent page's pane

The same cited-page pane opens from the Pages tab or a source's pane. The link beside its title opens the original page in a new tab. The pane shows that page's citations, citing prompts, citing answers and whether it names you.

**About** follows these figures when Heralded has the page's description. It comes from the description the page supplies, captured when Heralded reads it. A bar chart gives its citations by weekly report.

**Names** follows the trend. It lists only your brand and tracked competitors, with your brand first when named and marked **You**. **Recommends** appears beside a brand the page recommends. Opening a competitor's row opens its pane, with a back control to return. If Heralded couldn't read the page, it says "Heralded couldn't read this page." and omits **About**. A read page naming none of these brands says "This page names neither you nor a competitor you track."

**Prompts** lists the prompts whose answers cite the page, ten at a time, and each opens its prompt pane. **Engines** shows each citing engine's citation count. The closing link opens the answers citing that page.

The pane follows the period, engine, type, intent, topic, segment and prompt filters it was opened under. Owner, source type and names-you only narrow the Sources list. When you open it inside a source's pane, the back button returns to that source.

## How citations are counted

The period counts the last report, the last four reports, the last twelve reports or all of them. Each weekly report contributes citations from its own answers and from the daily updates it pooled, so a page cited only in daily updates counts in the weekly report that pools them. A failed week can fold into the next report, so four reports can cover more than four calendar weeks. The baseline holds as many earlier reports as the period, with at least four when four exist. Reports across a change of engines, market or scoring are not pooled.

For the same period and filters, the answer lists on Sources, Prompts and Competitors contain the same answers. Citations of prompts you still track are retained. If you stop tracking a prompt and its retention expires, its citations are removed, so a past period's count can drop.

Daily updates and weekly reports read newly cited pages the same way. Heralded reuses page text for your brand for seven days, then fetches it again when an answer next cites it. If you edit your brand profile or tracked competitors, Heralded rechecks that text against your current settings. The read records the page's facts and source type. If Heralded has no page verdict, it uses the answer's attribution when available, then whether the page is on one of your own domains.

A report without complete citation evidence contributes no measured citation counts. If some reports have evidence, the counts cover those reports and the read tells you how many lack evidence. If none have evidence, the cards are blank. Trends leave those reports blank and comparisons require evidence on both periods. Outreach suggestions keep their existing work until citation evidence is complete.

The API exposes `citation_evidence` as `complete`, `partial` or `unavailable`, with `unavailable_scans` for the selected period. Overview exposes these as `source_citation_evidence` and `source_unavailable_scans`. A site or cited-page pane returns HTTP 503 when missing evidence prevents it from finding the requested source or page.

## Answers citing you and sources mentioning you

Two figures count what the engines cite about you, and no cited page counts in both:

* **Answers citing you** is the share of answers that cite at least one page on your own site.
* **Sources mentioning you** is the share of pages on other sites, cited in the answers and read by Heralded, whose text names you. Competitors' pages count. A page cited several times, or under different tracking parameters, counts once. A page Heralded couldn't read or didn't check is left out, not counted as leaving you out.

Each covers one report and comes with what it is out of: the answers read, or the pages read on other sites. With nothing to count it is empty rather than zero. Open **Mentioned** on Home for both figures. A [Snapshot](/concepts/snapshot) report shows them in its **Source mix**.

Pages that contradict your claims or facts appear in their claim panes on [Perception](/methodology/how-ai-describes-you#the-page).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.