YouScan

YouScan Statistics API

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"`.

GitHub OpenAPI

Operations 13

GET /topics/{topicId}/statistics/sentiments Sentiment #
GET /topics/{topicId}/statistics/tags Tags #
GET /topics/{topicId}/statistics/words Word cloud #
GET /topics/{topicId}/statistics/countries Countries #
GET /topics/{topicId}/statistics/cities Cities #
GET /topics/{topicId}/statistics/regions-sentiments Sentiment by regions #
GET /topics/{topicId}/statistics/sources-sentiments Sentiment by sources #
GET /topics/{topicId}/statistics/regions-sources-sentiments Sentiment by sources by regions #
GET /topics/{topicId}/statistics/histogram Histogram #
GET /topics/{topicId}/statistics/genders Genders #
GET /topics/{topicId}/statistics/ages Ages #
GET /topics/{topicId}/statistics/links Links #
GET /topics/{topicId}/statistics/metrics Engagement metrics #

Documentation

📖
Documentation
https://developers.youscan.io/
📖
APIReference
https://developers.youscan.io/api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/youscan/refs/heads/main/openapi/youscan-statistics-api-openapi.yml

Other Resources

🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/youscan/refs/heads/main/llms/youscan-llms.txt

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/youscan-statistics-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

youscan-statistics-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: YouScan Statistics API
  version: '1.0'
  contact:
    name: YouScan Support
    url: https://youscan.io
  license:
    name: Proprietary
    url: https://youscan.io/terms-of-service
  description: 'YouScan provides a REST API to manage topics, retrieve mentions, and query statistics

    collected by the YouScan social media listening platform.'
servers:
- url: https://api.youscan.io/api/external
security:
- ApiKeyHeader: []
- ApiKeyQuery: []
tags:


# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/youscan/refs/heads/main/openapi/youscan-statistics-api-openapi.yml