# YouScan Statistics API

**Canonical:** https://apis.io/apis/youscan/youscan-statistics-api/  
**Provider:** YouScan — https://apis.io/providers/youscan/  
**Base URL:** https://api.youscan.io/api/external  
**Documentation:** https://developers.youscan.io/

YouScan Statistics API is one of 8 APIs that [YouScan](https://apis.io/providers/youscan/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Statistics. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Aggregated statistics for mentions of a topic. ### Dates `from` and `to` are dates (`yyyy-MM-dd`); `to` is inclusive. Day boundaries are computed in the API key owner's time zone (see *Dates and time zones* in the Mentions section). ### Filters All statistics endpoints accept a common set of optional filters: - `country` (`string[]`): e.g. `country=uk&country=us` - `excludeCountry` (`string[]`): e.g. `excludeCountry=uk&excludeCountry=us` - `sourceTypes` (`string[]`): one of `blog`, `forum`, `news`, `social`, `reviews`, `messenger` (e.g. `sourceTypes=social&sourceTypes=blog`) - `excludeSourceTypes` (`string[]`): same values as `sourceTypes` - `sources` (`string[]`): e.g. `sources=telegram.me&sources=youscan.io` - `excludeSources` (`string[]`): e.g. `excludeSources=telegram.me&excludeSources=youscan.io` - `tags` (`int[]`): filter by tag IDs - `excludeTag` (`int[]`): exclude filter by tag IDs Every statistics response contains a `totalCount` field — the total number of mentions matching the filters. An unknown or inaccessible `topicId` returns `404` with `message: "Theme not found"`.

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/youscan/refs/heads/main/openapi/youscan-statistics-api-openapi.yml
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/youscan/refs/heads/main/llms/youscan-llms.txt
- **Documentation** — https://developers.youscan.io/
- **APIReference** — https://developers.youscan.io/api/

## Other YouScan APIs (7)

- [YouScan Data Import API](https://apis.io/apis/youscan/youscan-data-import-api/)
- [YouScan History API](https://apis.io/apis/youscan/youscan-history-api/)
- [YouScan Mentions API](https://apis.io/apis/youscan/youscan-mentions-api/)
- [YouScan Spaces API](https://apis.io/apis/youscan/youscan-spaces-api/)
- [YouScan Tags API](https://apis.io/apis/youscan/youscan-tags-api/)
- [YouScan Topics API](https://apis.io/apis/youscan/youscan-topics-api/)
- [YouScan Webhook API](https://apis.io/apis/youscan/youscan-webhook-api/)

## Tags

Statistics

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/youscan/youscan-statistics-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/youscan/.