> For the complete documentation index, see [llms.txt](https://documentation.proto.cx/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.proto.cx/docs/modules/perception.md).

# Perception

{% hint style="info" %}
Perception monitors public mentions of your organisation across social media, news sites, and app stores — scraped, categorised, and scored for sentiment.
{% endhint %}

{% hint style="warning" %}
Perception is in early release. Only the **Data** tab is currently available; Raw Data, Alerts, Sources, Categorization, and Keywords tabs are not yet released.
{% endhint %}

Open Perception from the eye icon in the left navigation.

***

## Date range

Click the **Date range** chip to open the date picker. See [Interactions — Date range](/docs/modules/analytics/interactions.md) for full details of the date picker and presets. All data is shown in your workspace timezone.

***

## Summary tiles

| Metric                | What it shows                                            |
| --------------------- | -------------------------------------------------------- |
| Total scraped entries | All mentions collected across every source in the period |
| Social media posts    | Count and % of entries from social platforms             |
| News site mentions    | Count and % of entries from news sites                   |
| App store reviews     | Count and % of entries from app store reviews            |

***

## Top mentions

Three tables summarise what's being said, each broken down by source:

| Table                        | Columns                  |
| ---------------------------- | ------------------------ |
| **Top mentioned keywords**   | Source, Keyword, Count   |
| **Top mentioned categories** | Source, Category, Count  |
| **Top sentiment**            | Source, Sentiment, Count |

***

## Data breakdown

A chart of scraped entry volume over the selected period.

| Control      | Options                                           |
| ------------ | ------------------------------------------------- |
| Group by     | Hour, Day, Week, Month, Quarter, Year             |
| Segment by   | Dimension to split the chart by                   |
| Display mode | Actual or relative values                         |
| Source       | Filter to specific sources                        |
| Source type  | Filter to social media, news sites, or app stores |
| Sentiment    | Filter by sentiment score                         |
| Keywords     | Filter by specific keywords                       |

Select **Reset all** to clear filters.

***

## Side-by-side comparison

Two additional charts beneath Data breakdown, each independently configurable with the same Group by, Segment by, Display mode, Source, Source type, Sentiment, and Keywords controls — useful for comparing two cuts of the data at a glance.